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内 容 提 要 


本 书 是 Node.js 的 实战 教程 , 涵盖 了 为 开发 产品 级 Node 应 用 程序 所 需要 的 一 切 特性 、 技巧 以 及 相关 理念 。 
从 搭建 Node 开发 环境 ， 到 一 些 简 单 的 演示 程序 ， 到 开发 复杂 应 用 程序 所 必 不 可 少 的 异步 编程 。 第 2 版 介绍 
了 全 栈 开 发 者 所 需 的 全 部 技术 ， 包 括 前 端 构 建 系统 、 选 择 Web 框架 、 在 Node 中 与 数据 库 的 交互 、 编 写 测试 
和 部 署 Web 程序 ， 等 等 。 

本 书 适 合 Web 开发 人 员 阅 读 。 
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的 变化 。Node 的 包 管 理 器 孵化 出 了 一 家 成 功 的 新 公司 
了 Node 开发。 


《Node.js 实战 》 的 第 1 版 出 版 之 后 发 生 了 很 多 如 





事情 ，io.js 问世 ， 治 理 模 型 也 发 生 了 翻天 覆 地 
npm，Babel 和 Electron 等 技术 也 改变 
虽然 Node 的 核心 库 变 化 不 大 , 但 JavaScript 变 了 ,大 多 数 开 发 人 员 都 用 上 了 ES2015 的 功能 
特性 ， 所 以 我 们 改写 了 上 一 版 中 的 所 有 代码 ， 用 上 了 箭头 函数 、 常 量 和 解构 。 因 为 Node 的 库 和 



































自 带 的 工具 看 起 来 仍然 和 4x 之 前 的 版 本 差不多 ， 所 以 我 们 在 这 一 版 的 更 新 中 瞄准 了 社区 。 
为 了 体现 Node 开发 人 员 在 实际 工作 中 面临 的 问题 ， 本 书 在 结构 上 进行 了 调整 。Express 和 
Connect 的 分 量 轻 了 ， 涉 及 的 技术 范围 
构建 系统 、 选 择 Web 框架 、 


除了 Web 开发 , 本 书 还 有 编 
Node 和 JavaScript 技能 。 

















本 DY 


在 Node 中 与 数据 库 的 交互 、 编 写 涡 
安全 公 


广 了 。 书 中 介绍 了 全 栈 开发 者 所 需 的 全 部 技术 ,包括 前 端 
景 知识 








| 试 和 部 署 Web 程序 。 





行程 序 和 Electron 桌面 程序 的 章节 , 让 你 充分 利用 自己 的 
本 书 不 仅 要 向 你 介绍 Node 和 它 的 生态 系统 ， 还 想 尽 可 能 让 你 了 解 那些 影响 Node 发 展 的 背 
题 时 找到 解决 办 法 。 


比如 一 般 在 Node 和 JavaScript 书籍 中 并 不 介绍 的 Unix 哲学 和 如 何 正确 、 安 全 地 使 用 数 
据 库 。 和 希望 这 些 知识 能 拓宽 你 的 眼界 ， 加 深 你 对 Node 和 JavaScript 的 理解 ， 帮 你 在 面临 新 的 问 
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关于 本 书 








本 书 第 1 版 重点 介绍 了 如 何 用 Web 框架 Connect 和 Express 开发 Web 程序 。 第 2 版 则 根据 
Node 开发 的 变化 做 了 调整 。 我 们 会 介绍 前 端 构建 系统 、 流 行 的 Node Web 框架 ， 以 及 如 何 用 Express 
从 头 开 始 搭建 Web 程序 ， 还 会 讲 到 自动 化 测试 和 Node Web 程序 的 部 署 。 

因为 用 Node 做 的 命令 行 开发 者 工具 和 用 Electron 做 的 桌面 端 程序 越 来 越 多 ， 所 以 本 书 专 门 
用 了 两 章 的 篇 幅 分 别 介绍 这 两 块 内 容 。 

本 书 假定 你 熟悉 基本 的 编程 概念 。 但 考虑 到 有 些 开发 人 员 还 没有 接触 过 新 的 JavaScript， 所 
以 第 1 章 将 会 介绍 JavaScript 和 ES2015。 


路 线 


本 书 分 为 三 部 分 。 
第 一 部 分 介绍 Node.js， 讲 解 用 它 进行 开发 所 需 的 基础 技术 。 第 1 章 介 绍 了 JavaScript 和 Node 
的 特性 ， 通 过 示例 代码 一 步 步 进行 讲解 。 第 2 章 介绍 了 基本 的 Node.js 编程 概念 。 第 3 章 完 整地 
演示 了 如 何 从 头 开 始 搭 建 一 个 Web 程序 。 

第 二 部 分 重点 介绍 Web 开发 ， 内 容 最 多 ， 篇 幅 也 最 长 。 第 4 章 是 前 端 构 建 系统 的 揭秘 。 如 
果 你 在 项 目 中 用 到 过 Webpack 或 Gulp, 但 并 没有 真正 掌握 它们 ， 那 么 可 以 学 习 一 下 这 一 章 的 内 
容 。 第 5 章 介 绍 了 Node 中 最 流行 的 服务 器 端 框架 。 第 6 章 详细 介绍 了 Connect 和 Express。 第 7 
章 是 模板 语言 ， 它 可 以 提升 服务 端 代码 的 编写 效率 。 大 多 数 Web 程序 都 需要 数据 库 ， 所 以 第 8 
章 介绍 了 很 多 种 可 以 用 在 Node 中 的 数据 库 ， 关 系 型 和 NoSQL 都 有 涉及 。 第 9 章 和 第 10 章 讲 了 
测试 和 部 署 ， 包 括 云端 部 署 。 

第 三 部 分 是 Web 程序 开发 之 外 的 内 容 。 第 11 章 讲 了 如 何 用 Node 搭建 命令 行程 序 ， 创 建 出 
开发 人 员 熟 悉 的 文字 界面 。 如 果 你 喜欢 用 Node 搭建 像 Atom 一 样 的 桌面 程序 ,可 以 看 看 介绍 Electron 
的 第 12 章 。 

本 书 还 有 三 个 附录 。 附 录 A 讲 了 如 何在 macOS 和 Windows 上 安装 Node， 附 录 B 详细 介绍 
了 如 何 实现 网 络 内 容 抓 取 ， 附 录 C 介绍 了 Connect 的 官方 中 间 件 组 件 。 


编码 规范 及 下 载 
书 中 的 代码 遵循 通用 JavaSceript 规 范 。 缩 进 用 空格 ， 不 用 制 表 符 。 尽 量 不 要 让 一 行 代码 的 长 









































































































































2 关于 本 书 








度 超过 80 个 字符 。 很 多 代码 清单 中 都 加 了 注释 ， 指 出 了 其 中 的 关键 概念 。 

每 行 一 条 语句 , 简单 语句 后 面 加 分 号 。 代 码 块 放 在 大 括号 中 ,， 左 括号 放 在 代码 块 开始 行 的 未 
尾 处 , 右 括 号 的 缩 进 跟 代码 块 开始 行 的 缩 进 保持 一 致 ， 在 垂直 方向 上 对 齐 。 

书 中 示例 的 源码 请 至 图 灵 社 区 本 书 主 页 http://www.ituring.com.cn/book/1993 随 书 下 载 处 下 载 。 


本 书 论坛 

购买 了 英文 版 的 读者 可 以 免费 访问 Manning 出 版 社 运营 的 专 享 论坛 , 你 可 以 在 那里 发 表 对 图 
书 的 评论 ， 提 出 技术 问题 ， 寻 求 作 者 和 其 他 读者 的 帮助 。 

Manning 的 初衷 是 为 读者 间 、 读 者 与 作者 间 提 供 一 个 交流 场所 。 作 者 完全 可 以 根据 个 人 意愿 
进行 参与 ,在 论坛 上 所 做 的 贡献 是 没有 报酬 的 .所 以 我 们 建议 你 尽 可 能 提出 一 些 有 挑战 性 的 问题 ， 
以 激发 作者 的 兴趣 ! 只 要 书 还 在 发 行 , 出 版 社 的 网 站 上 就 会 有 关于 书 的 论坛 和 之 前 讨论 过 的 内 容 
的 归档 。 

读者 也 可 登录 图 灵 社 区 本 书 主页 http://www.ituring.com.cn/book/1993 提交 反馈 意见 和 勘误 。 































































































关于 封面 图 片 





本 书 封面 上 的 画像 标题 为 “城镇 里 的 男人 ”, 摘自 19 世纪 法 国 出 版 的 沙 利文 马 雷 夏 尔 ( Sylvain 
Maréchal ) 四 卷 本 的 地 域 服饰 风俗 摘要 。 其 中 每 幅 插图 都 是 手工 精心 绘制 并 上 色 的 。 马 雷 夏 尔 这 
套 书 展示 的 丰富 服饰 ， 令 我 们 强烈 感受 到 2000 年 前 乡村 与 城镇 的 巨大 文化 差异 。 不 同 地 域 的 人 
山水 阻隔 ,语言 不 通 。 无 论 奔走 于 街坊 ， 还 是 驻足 于 乡间 ， 通 过 他 们 的 服饰 ， 一 眼 就 能 看 出 他 们 
的 生活 场所 、 职 业 ， 以 及 生活 境况 。 

时 过 境 迁 ， 书 中 描绘 的 那些 区 域 性 服饰 差异 如 今 已 经 不 复 存 在 。 即 使 是 不 同 国家 ,都 很 难 再 
看 出 人 们 着 装 的 区 别 ， 再 不 必 说 城镇 和 乡村 了 。 或 许 , 我 们 今天 多 姿 多 彩 的 人 生 , 正 是 从 前 那些 
文化 差异 的 体现 。 只 不 过 ， 如 今 的 生活 更 加 多 元 ， 而 且 技术 环境 下 的 生活 节奏 也 更 快 了 。 

今 时 今日 ,计算 机 图 书 层出不穷 ，Manning 就 以 马 雷 夏 尔 这 套 书 中 多 样 性 的 图 片 ,来 表达 对 
行业 日 新 月 异 的 发 明 与 创造 的 赞美 。 












































图 灵 社 区 会 员 georgehpj(hupeijiegeorge@hotmail.com) 专 享 尊重 版 权 
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现 如 今 ， Node 已 经 出 落成 了 一 个 成 熟 的 Web 开发 平台 。 本 书 第 1 章 到 第 3 章 介绍 Node 
的 主要 特性 ， 包 括 如 何 使 用 npm 和 Node 的 核心 模块 。 你 还 将 看 到 如 何在 Node 上 使 用 现代 版 
JavaScript， 以 及 如 何 从 头 开始 构建 一 个 Web 应 用 程序 。 看 完 这 些 章 市 之 后 ， 对 于 Node 能 做 什 
么 ， 以 及 该 如 何 创建 自己 的 项 目 ， 你 将 会 有 非常 深刻 的 认识 。 

















欢迎 进入 Node.js 的 性 再 








本 章 内 容 

口 Nodejs 是 什么 

口 定义 Node 应 用 程序 
口 使 用 Node 的 优势 
口 异步 和 非 阻 塞 IO 














Nodejs 是 一 个 JavaScript 运行 平台 , 其 显著 特征 是 它 的 异步 和 事件 驱动 机 制 ， 以 及 小 巧 精 悍 
的 标准 库 。Node 目前 有 两 个 活跃 版 本 : 长 期 支持 版 (LTS ) 和 当前 版 ， 由 Node.js 基金 会 进行 管 
理 并 提供 支持 。 这 个 行业 联盟 遵循 开放 式 治 理 模 型 ， 如 果 想 了 解 更 多 与 Node 管理 相关 的 信息 ， 
可 以 查阅 其 官网 上 的 文档 。 

自 2009 年 Nodejs 问世 以 来 ，JavaScript 渐渐 变 成 了 能 开发 所 有 软件 的 语言 ， 其 地 位 也 越 来 
越 重要 ,不 再 是 只 能 勉强 在 浏览 器 上 用 一 下 的 鸡肋 语言 7。 这 里 有 ECMAScript 2015 的 功劳 ， 
为 它 解决 了 之 前 那些 ECMAScript 标准 中 遗留 下 来 的 几 个 关键 问题 。 Node 所 用 的 Google V8 引擎 
就 是 基于 ECMAScript 2015 开发 的 。ECMAScript 2015 是 ECMAScript 标准 的 第 6 个 版 本 ， 所 以 
有 时 也 被 称 为 ES6， 一 般 简 写 为 ES2015。Node 、React 和 Electron 等 技术 创新 成 果 的 功劳 也 不 可 
小 舰 ， 是 它们 让 JavaScript 无 处 不 在 : 从 服务 器 到 浏览 器 ， 到 原生 的 移动 端 应 用 程序 。 甚 至 像 微 
软 这 样 的 大 公司 都 对 JavaScript 敞开 了 怀抱 ， 也 为 Node 的 成 功 起 到 推波助澜 的 作用 。 

本 章 更 深入 介绍 Node、Node 的 事件 驱动 非 阻 塞 模型 ， 以 及 JavaScript 成 为 优秀 的 通用 编程 
语言 的 一 些 原因 。 下 面 先 介绍 一 个 典型 的 Node Web 应 用 程序 。 


1.1 一 个 典型 的 Node Web 应 用 程序 


大 体 上 来 说 , Node 和 JavaScript 的 优势 之 一 是 它们 的 单线 程 编程 模型 。 多 个 线程 一 般 会 引入 
bug， 尽 管 一 些 新 的 编程 语言 ， 包 括 Go 和 Rust， 试 图 提供 更 加 安全 的 并 发 工具 , 但 Node 仍然 保 
留 了 JavaScript 在 浏览 器 中 所 用 的 模型 。 在 为 浏览 器 编写 代码 时 ， 我 们 写 的 指令 序列 一 次 执行 
条 ,代码 不 是 并 行 执行 的 。 然 而 对 于 用 户 界面 来 说 ， 这样 是 不 合理 的 : 没有 哪个 用 户 想 在 浏览 
执行 网 络 访问 或 文件 获取 这 样 的 低速 操作 时 干 等 着 。 为 了 解决 这 个 问题 ， 浏 览 锅 引入 了 事件 机 制 
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在 你 点 击 按 钮 时 ,就 有 一 个 事件 被 触发 , 还 有 一 个 之 前 定义 的 函数 会 跑 起 来 。 这 种 机 制 可 以 规避 
一 些 在 线程 编程 中 经 常 出 现 的 问题 ， 比 如 资源 死 锁 和 竞 态 条 件 。 





1.1.1 非 阻塞 1O 


那么 在 服务 器 端 编程 中 , 这 有 什么 意义 呢 ? 其 实 服务 器 端 编程 面 对 的 情况 也 差不多 : 访问 磁 
盘 和 网 络 这样 的 IO 请 求 会 比较 慢 ， 所 以 我 们 希望 ， 在 读 取 文件 或 通过 网 络 发 送 消 息 时 ， 运 行 平 
台 不 会 阻塞 业务 逻辑 的 执行 。Node 用 三 种 技术 来 解决 这 个 问题 事件、 异步 API、 非 阻塞 IO。 
在 Node 程序 员 看 来 ， 非 阻塞 IO 是 个 底层 术语 。 它 的 意思 是 说 ， 你 的 程序 可 以 在 做 其 他 事情 时 
发 起 一 个 请 求 来 获取 网 络 资源 , 然后 当 网 络 操作 完成 时 , 将 会 运行 一 个 回调 函数 来 处 理 这 个 操作 
的 结果 。 

1-1 展示 了 一 个 典型 的 Node Web 应 用 程序 ， 它 用 Web 应 用 库 Express 来 处 理 商 店 的 订单 
流程 。 为 了 购买 产品 , 浏览 器 发 起 了 一 个 请 求 , 然后 应 用 程序 检查 库存 , 为 该 用 户 创建 一 个 账号 ， 
发 回执 邮件 ， 并 返回 一 个 JSON HTTP 啊 应 给 浏览 器 。 同 时 在 做 的 其 他 事情 有 : 发 送 了 一 封 回执 
邮件 ， 更 新 了 数据 库 来 保存 用 户 的 详细 信息 和 订单 。 代 码 本 身 很 简单 ， 就 是 JavaScript 指令 ， 但 
运行 平台 是 并 发 操作 的 ， 因 为 它 用 了 非 阻 塞 IO。 




















































































































应 用 程序 Node 和 Express 
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请 求 体 : 订单 信息 
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JavaScript 


错误 对 象 











图 1-1 一 个 Node 应 用 程序 中 的 异步 非 阻塞 组 件 
在 图 1-1 中 , 数据 库 是 通过 网 络 访问 的 。Node 中 的 网 络 访问 是 非 阻塞 的 ， 它 用 了 一 个 名 为 
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libuv 的 库 来 访问 操作 系统 的 非 阻塞 网 络 调用 。 这 个 库 在 Linux 、macOS 和 Windows 中 的 实现 是 
不 同 的 ， 但 不 用 担心 ， 因 为 你 只 需要 会 用 操作 数据 库 的 JavaScript 库 就 可 以 了 。 只 要 写 一 些 
db.insert (query，err => {}) 这 样 的 代码 ，Node 就 会 帮 你 完成 那些 经 过 高 度 优化 的 非 阻 塞 
网 络 操作 。 

访问 硬盘 也 差不多 , 但 又 不 完全 一 样 。 在 生成 了 回执 邮件 并 从 硬盘 中 读 取 邮件 模板 时 ，libuv 
背 助 线程 池 模 拟 出 了 一 种 使 用 非 阻 塞 调用 的 假象 。 管 理 线程 池 是 个 音 差 事 ， 相 较 而 言 ， 
email.send('template.ejs'，(err，html) => {}) 这 样 的 代码 肯定 要 容易 理解 得 多 了 。 

在 进行 速度 较 慢 的 处 理 时 让 Node 能 做 其 他 事情 ， 是 使 用 带 非 阻塞 IO 的 异步 API 真正 的 好 
处 。 即 便 你 只 有 一 个 单线 程 、 单 进程 的 Node Web 应 用 ， 它 也 可 以 同时 处 理 上 千 个 网 站 访客 发 起 
的 连接 。 要 想 知道 Node 是 如 何 做 到 的 ， 得 先 研 究 一 下 事件 轮 询 。 


1.1.2 事件 轮 询 


我 们 把 图 1-1 放大 , 仔细 研究 “响应 浏览 器 的 请 求 ” 那 部 分 。 在 这 个 应 用 程序 中 ,Node 内 置 
的 HTTP 服务 器 库 ， 即 核心 模块 nttp .server， 负责 用 流 、 事 件 、Node 的 HTTP 请 求解 析 器 的 
组 合 来 处 理 请 求 ， 它 是 本 地 代码 。 你 用 Express Web 应 用 库 添加 的 回调 函数 ， 也 是 由 它 触 发 的 。 
这 个 回调 函数 又 会 触发 数据 库 查 询 语句 ， 最 终 应 用 程序 会 用 HITP 发 送 JSON 作为 响应 。 整 个 过 
程 用 了 三 个 非 阻 塞 网 络 调用 : 一 个 用 于 请 求 ， 一 个 用 于 数据 库 ， 还 有 一 个 用 于 响应 。Node 是 如 
何 调配 这 些 网 络 操作 的 呢 ? 答案 是 事件 轮 询 〈event loop )。 图 1-2 展示 了 如 何 用 事件 轮 询 完成 这 
三 个 网 络 操作 。 
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事件 轮 询 网 
1. 请 求 调用 2. 数 据 库 调 | 3. 响 应 调 | 
运行 
调 | 函数 ， 向 浏览 器 发 送 
post/order 创建 用 户 JSON 























图 1-2 事件 轮 询 





事件 轮 询 是 单 向 运行 的 先 人 先 出 队列 , 它 要 经 过 几 个 阶段 , 轮 询 中 每 个 迭代 都 要 运行 的 重要 
阶段 已 经 在 图 1-2 中 展示 出 来 了 。 首 先是 计时 器 开始 执行 ， 这 些 计时 器 都 是 用 JavaScript 函数 
setTimeout 和 setInterval 安排 好 的 。 接 下 来 是 运行 IO 回调 ， 即 触发 你 的 回调 函数 。 轮 询 
阶段 会 去 获取 新 的 IO 事件 , 最 后 是 用 setImmediate 安排 回调 。 这 是 一 个 特例 ， 因为 它 允 许 你 
将 回调 安排 在 当前 队列 中 的 IO 回调 完成 之 后 立即 执行 。 现 在 你 可 能 还 会 觉得 有 点 儿 抽 象 ， 不 过 







































































1.2 ES2015、Node 和 V8 5 








只 需要 记 住 ， 尽 管 Node 是 单线 程 的 ， 但 你 仍然 可 以 用 它 提供 的 工具 写 出 可 伸缩 的 高 效 代码 。 
你 可 能 注意 到 了 ， 前 面 几 页 中 的 代码 用 到 了 ES2015 的 箭头 函数 。Node 支持 很 多 JavaScript 
的 新 特性 ， 所 以 我 们 想 先 带 你 看 一 看 能 用 哪些 新 特性 来 写 出 更 棒 的 代码 , 然后 再 继续 介绍 Node。 























1.2 ES2015、Node 和 V8 


如 果 你 以 前 曾 因 JavaScript 没 有 类 而 伤心 难过 ， 或 者 被 它 奇 怪 的 作用 域 规则 搞 得 头 举 脑 胀 ， 
那 你 肯定 会 喜欢 我 们 接 下 来 要 讲 的 内 容 。Node 解决 了 很 多 问题 ! 现在 你 可 以 创建 类 了 ! const 
和 let (代替 了 var ) 解决 了 作用 域 的 问题 。 从 Node 6 开始， 你 可 以 用 默认 函数 参数 、 剩 余 参 
数 、spread 操作 符 、for.. .of 循环 、 模 板 字 符 串 、 和 解构、 生成 右 等 很 多 新 特性 。http://node.green 
上 汇总 了 Node 支持 的 ES2015 特性 ， 建 议 你 看 一 下 。 

先 说 类 。 在 ES5 及 之 前 的 版 本 中 ， 我 们 要 用 prototype 对 象 来 创建 类 似 于 类 的 结构 : 


function User() { 
// 构造 器 
} 























User.prototype.method = function() { 
// 方法 
和 


有 了 Node6 和 ES201$， 你 可 以 用 类 将 上 面 的 代码 写成 : 


class User { 
constructor() {} 
method() {} 

} 


代码 少 了 ， 也 更 容易 理解 了 。 但 还 不 止 于 此 ，Node 也 支持 子 类 、 超 类 和 静态 方法 。 对 于 熟 
悉 其 他 语言 的 人 来 说 ， 采 用 了 类 语法 的 Node 比 ES5 更 好 用 。 

const 和 let 是 从 Node4 开 始 支持 的 。 在 ES5 中 ,所 有 变量 都 是 用 var 创建 的 。 不 管 是 在 
函数 中 还 是 全 局 作用 域 中 ,都 是 用 var 定义 变量 ,所 以 我 们 没 办 法 在 if 语句 、for 循环 以 及 其 
他 块 中 定义 块 级 别 的 变量 。 



































我 应 该 用 const 还 是 let 
在 决定 是 用 const 还 是 用 let 时 ， 几 乎 都 可 以 用 const。 因 为 你 的 大 部 分 代码 都 是 在 用 
你 自己 的 类 实例 、 对 象 常量 或 不 会 变 的 值 ， 所 以 大 部 分 情况 下 都 可 以 用 const。 即 便 是 有 可 
修改 属性 的 对 象 ， 也 是 可 以 用 const 声明 的 ， 因 为 const 的 意思 是 引用 是 只 读 的 ， 而 不 是 值 
是 不 可 变 的 。 

















Node 还 有 原生 的 promise 和 生成 器 。 为 了 让 我 们 能 用 流畅 的 接口 风格 编写 异步 代码 , 有 很 多 
库 都 支持 promise。 对 于 流畅 的 接口 风格 ， 你 可 能 并 不 陌生 ， 如 果 你 用 过 jQuery 之 类 的 API， 甚 
至 只 要 用 过 JavaScript 数组 ， 就 已 经 见 过 它 是 什么 样 的 了 。 下 面 就 是 一 个 将 调用 链 起 来 处 理 数组 
的 小 例子 : 
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[ds 125 3:] 
.map(n => n * 2) 
.filter(n => n > 3); 


生成 器 能 把 异步 IO 变 成 同步 编程 风格 。Koa Web 应 用 库 中 用 到 了 生成 器 ， 你 可 以 研究 一 下 
它 的 代码 以 了 解 生成 器 的 用 法 。 如 果 结 合 Koa 使 用 promise 和 其 他 生成 颖 ， 你 就 可 以 抛 开 层 层 器 
套 的 回调 ， 在 值 上 yieldo 

ES2015 中 的 模板 字符 串 在 Node 中 也 很 好 用 。 在 ES5 中 , 字符 串 常量 不 支持 插值 ， 也 不 能 
行 。 现 在 我 们 可 以 用 反 引 号 (` ) 定义 模板 字符 串 ， 不 仅 可 以 插值 ， 而 且 还 可 以 跨行 。 比 如 像 下 
面 这 个 例子 一 样 ， 在 Web 应 用 中 直接 定义 一 小 段 HTML 模板 : 

this.body = .、 

<div> 
<hi>Hello from Node</h1i> 


<p>Welcome, S${user.name}!</p> 
</div> 




















在 ES5 中 ， 前 面 那个 例子 只 能 写成 这 样 : 


thies Dd SN 

this.body += '<div>\n'; 

this.body += <hil>Hello from Node</hl>\n'; 
this.body += <p>Welcome, ' + user.name + '</D>Nn' 


this.body + 

老 套路 不 仅 代码 多 ， 而 且 还 容易 出 错 。 对 Node 程序 员 来 说 ， 最 后 一 个 非常 重要 的 特性 是 箭 
头 函数 。 箭 头 函 数 的 语法 非常 精炼 。 比 如 说 ， 如 果 你 要 写 有 一 个 参数 和 一 个 返回 值 的 回调 函数 ， 
那么 像 下 面 这 么 简单 就 可 以 : 

[En Dn 3 naB(y se V2) 

在 Node 中 ,我们 一 般 会 需要 两 个 参数 ， 因 为 回调 的 第 一 个 参数 通常 是 错误 对 象 。 这 时 候 需 
要 用 括号 把 参数 括 起 来 : 

const fs = require('fs'); 

fs.readFile('package.json', 


(err, text) => console.log('Length:', text.length) 

) 守 
如 果子 数 体 的 代码 不 止 一 行 , 则 需要 用 到 大 括号 。 篆 头 函 数 的 价值 不 仅 体 现在 其 精炼 的 语法 
上 ， 还 跟 JavaScript 作用 域 有 关 。 在 ES5 及 之 前 版 本 的 语言 中 ， 在 函数 中 定义 函数 会 把 this 引 
用 变 成 全 局 对 象 。 就 因为 这 个 问题 ， 下 面 这 种 按 ES5 写 的 类 很 容易 出 错 : 

function User(id) { 

// 构造 器 

让 打下 全 和 本 和 ST 


SN 

































































User.prototype.load = function() { 
var self = this; 
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sql.gquery (query, this.id, function(err, users) { 
self.name = users[0] .name; 
对 | 

> 


Var query = 'SELECT * FROM users WHERE id = ?'; 


给 self.name 赋值 那 行 代码 不 能 写成 this.name, 因为 这 个 函数 的 this 是 个 全 局 变量 


之 里 o 
常用 的 解决 办 法 是 在 函数 的 和 人口 处 将 this 赋值 给 一 个 变量 。 但 箭头 函数 的 绑 定 没有 这 个 问题 。 
所 以 在 ES2015 中 ， 上 面 这 个 例子 可 以 改写 成 更 加 直观 的 形式 : 
class User { 
constructor(id) { 
this.id = id; 
} 


























load() { 
const query = 'SELECT * FROM users WHERE id = ?1 
sql.query (query, this.id, (err, users) => { 
this.name = users[0] .name; 
}); 
} 
} 


你 不 仅 可 以 用 const 更 好 地 建 模 数据 库 查 询 ， 而 且 还 去 掉 了 麻烦 的 self 变量 。 让 Node 代 


码 变 得 更 容易 理解 的 ES2015 的 特性 还 有 很 多 ， 篇 幅 所 限 就 不 一 一 介绍 了 。 但 我 们 接 下 来 要 看 看 
这 都 是 谁 的 功劳 ， 以 及 它 与 之 前 讲 的 非 阻塞 /O 有 什么 关系 。 


1.2.1 Node 与 V8 























Node 的 动力 源 自 V8 JavaScript 引 擎 ,是 由 服务 于 Google Chrome 的 Chromium 项 目 组 开发 的 。 
V8 的 一 个 值得 称道 的 特性 是 它 会 被 JavaScript 直接 编译 为 机 器 码 ， 另 外 它 还 有 一 些 代 码 优化 特 
性 ,所 以 Node 才能 这 么 快 。 在 1.1.1 节 , 我 们 曾 提 到 过 Node 的 另 一 个 本 地 部 件 libuv， 它 是 负责 
处 理 IO 的 。V8 负责 JavaScript 代码 的 解释 和 执行 。 用 C++ 绑 定 层 可 将 libuv 和 V8 结合 起 来 。 
图 1-3 给 出 了 组 成 Node 的 所 有 软件 组 件 。 


你 的 宝贝 appjs 








Node.js 平 台 的 JavaScript、C 和 C++ 库 


Node 的 JavaScript 核 心 模块 





V8 





( CH+ 绑 定 ] 


libuv C-ares http 
操作 系统 


图 1-3 ”Nodejs 的 软件 栈 
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因此 ，Node 中 能 用 的 JavaScript 特性 都 可 以 追溯 到 V8 对 该 特性 的 支持 。 这 一 支持 是 通过 特 
性 组 来 管理 的 。 


1.2.2 ”使 用 特性 组 


Node 包含 了 V8 提供 的 ES2015 特性 。 这 些 特性 分 为 shipping 、staged 和 in progress 三 组 。 
shipping 组 的 特性 是 默认 开启 的 ，staged 和 in progress 组 的 特性 则 需要 用 命令 行 参 数 开 启 。 如 果 
你 想 用 staged 特性 ， 可 以 在 运行 Node 时 加 上 参数 --narmony，V8 团队 将 所 有 接近 完成 的 特性 
都 放 在 了 这 一 组 。 然 而 ，in progress 特性 稳定 性 较 差 ， 需 要 具体 的 特性 参数 来 开启 。Node 的 文档 
建议 通过 grep "in progress" 来 查询 当前 可 用 的 in progress 特性 : 

node --v8-options | grep "in progress" 

在 不 同 的 Node 版 本 中 执行 这 条 命令 后 得 到 的 结果 也 是 不 同 的 。Node 自己 也 有 个 版 本 计划 ， 
定义 了 它 要 提供 哪些 API。 


1.2.3 了 解 Node 的 发 布 计 划 


Node 的 发 行 版 分 为 长 期 支持 版 (LTS )、 当 前 版 和 每 日 构建 版 三 组 。 LTS 版 有 18 个 月 的 支持 
服务 , 期 满 后 还 有 12 个 月 的 维护 性 支持 服务 。 版 本 号 是 按照 语义 版 本 ( SemVer ) 编制 的 。 SemVer 
给 每 个 版 本 定义 了 一 个 主要 、 次 要 和 补丁 版 本 号 。 比 如 6.9.1 的 主要 版 本 号 是 6, 次 要 版 本 号 是 9， 
补丁 版 本 号 是 1。 只 要 看 到 主 版 本 号 发 生变 化 ， 那 就 意味 着 有 些 API 可 能 不 兼容 了 ， 也 就 是 说 如 
果 要 用 这 个 版 本 的 Node, 那么 你 的 项 目 需要 重新 测试 一 下 。 另 外 , 按 Node 的 发 布 规则 ， 主 版 本 
号 增长 意味 着 新 的 当前 版 也 已 经 切 下 来 了 。 每 日 构建 版 的 构建 是 自动 进行 的 , 每 隔 24 小 时 一 次 ， 
包含 这 24 小 时 内 的 最 新 修改 ， 但 一 般 只 用 来 测试 Node 的 最 新 特性 。 

用 哪个 版 本 取决 于 你 的 项 目 和 组 织 。 有 些 人 可 能 喜欢 更 新 不 那么 频繁 的 LTS,， 对 于 那些 难以 
管理 频繁 更 新 的 大 公司 来 说 ， 这 个 版 本 可 能 更 好 。 但 如 果 你 想 跟 上 性 能 和 功能 的 改进 ， 当 前 版 更 


合适 。 






















































































1.3 安装 Node 


安装 Node 的 最 简单 的 方法 是 使 用 其 官网 上 的 安装 程序 。 可 以 用 对 应 Mac 或 Windows 的 安装 
程序 安装 最 新 的 当前 版 ( 写作 本 书 时 是 6.5 )。 或 者 用 操作 系统 上 的 包 管 理 器 ，Debian 、Ubuntu、 
Arch 、Fedora 、FreeBSD 、Gentoo 和 SUSE 全 都 有 安装 包 ， 另 外 还 有 Homebrew 和 SmartOS 的 安 
装 包 。 如 果 没 有 能 用 在 你 的 操作 系统 上 的 包 ， 也 可 以 下 载 源码 自己 构建 。 
































提示 附录 A 提供 了 更 加 详细 的 Node 安装 指南 。 


Node 官网 (https:/nodejs.org/zh-cn/download/ ) 上 有 个 包含 所 有 安装 包 的 列表 , 源码 在 GitHub 


1.4 Node 自 带 的 工具 9 








( https://github.com/nodejs/node ) 上 。 建 议 收藏 一 下 Node 在 GitHub 上 的 项 目 主页 以 备 不 时 之 需 ， 
比如 有 时 候 你 可 能 想 看 看 它 的 源码 。 

装 好 之 后 ， 可 以 在 终端 中 输入 node -v 来 试 一 下 。 这 个 命令 应 该 会 输出 你 所 安装 的 Node 
的 版 本 号 。 接 下 来 ， 创 建 一 个 名 为 hellojjs 的 文件 ， 内 容 如 下 所 示 : 


console.log("hello from Node"); 


保存 文件 ， 输入 node hello.js 运行 它 。 茶 喜 你 ! 都 准备 好 了 ， 你 可 以 开始 用 Node 写 程 
序 了 ! 








在 Windows、Linux 和 macOS 上 快速 上 手 

如 果 你 刚 开 始 接触 编程 ， 还 没 找到 自己 喜欢 的 文本 编辑 器 ， 那 么 Visual Studio Code 是 个 
不 错 的 选择 。 这 是 微软 开发 的 ， 但 开源 ， 可 以 免费 下 载 ， 支 持 Windows、Linux 和 macOS。 

Visual Studio Code 为 新 手提 供 了 一 些 友好 的 辅助 功能 ， 包 括 JavaScript 语法 高 亮 、Node 
核心 模块 自动 补足 等 。 所 以 你 的 JavaScript 代码 看 起 来 会 更 清晰 ， 并且 你 在 输入 时 还 能 看 到 一 
个 所 支持 方法 和 对 象 的 列表 。 它 还 有 个 命令 行 界面 ， 可 以 输入 Node 来 调用 Node。 有 了 这 个 
命令 行 界面 ,需要 运行 Node 和 npm 命令 时 会 很 方便 。Windows 用 户 可 能 会 觉得 这 个 比 cmd.exe 
好 用 。 我 们 的 代码 都 在 Windows 上 用 Visual Studio Code 测试 过 ， 所 以 应 该 不 需要 任何 特殊 的 
东西 来 运行 本 书 中 的 例子 。 

可 以 从 参照 Visual Studio Code Node.js 教程 开始 。 
































Node 还 有 一 些 自 带 的 工具 。 它 不 单单 是 一 个 解释 器 ， 而 是 由 一 套 工 具 组 成 的 平台 。 接 下 来 
我 们 详细 介绍 一 下 这 些 工 具 。 




















1.4 Node 自 带 的 工具 


Node 自 带 了 一 个 包 管 理 器 , 以 及 从 文件 和 网 络 IO 到 zlib 压缩 等 无 所 不 包 的 核心 JavaScript 
模块 ， 还 有 一 个 调试 器 。npm 包 管 理 器 是 这 个 基础 设施 中 的 重要 组 成 部 分 ， 也 是 我 们 要 重点 介 
绍 的 。 

如 果 你 想 检 查 一 下 Node 是 否 已 经 安装 成 功 ， 可 以 在 命令 行 里 运行 node -v 和 npm -v。 这 

两 个 命令 分 别 用 来 显示 你 所 安装 的 Node 和 npm 的 版 本 。 









































1.4.1 npm 


命令 行 工 具 npm 是 用 npm 调用 的 。 你 可 以 用 它 来 安装 npm 注册 中 心里 的 包 ， 也 可 以 用 它 来 
查找 和 分 享 你 自己 的 项 目 ， 开 源 的 和 财源 的 都 行 。 注 册 中 心里 的 每 个 npm 包 都 会 有 个 页 面 显示 
它 的 自述 文件 、 作者 和 下 载 统计 信息 息 。 

另外 ，npm 还 是 一 家 提供 npm 服务 的 公司 的 名 字 。 这 家 公司 为 企业 提供 商业 服务 ， 包 括 托 
































10 第 1 章 欢迎 进入 Nodejs 的 世界 





管 私 有 的 npm 包 。 你 可 以 按 月 支付 服务 费 ， 把 公司 的 源码 托管 给 他 们 ， 这 样 你 的 JavaScript 开发 
人 员 就 可 以 用 npm 轻松 安装 你 的 私有 包 了 。 

在 用 npm 安装 这 些 包 时 ， 你 要 决定 是 装 在 你 的 项 目 中 还 是 装 在 全 局 。 要 全 局 安装 的 包 一 般 
是 工具 ， 即 你 要 在 命令 行 里 运行 的 程序 ， 比 如 gulp-cli 包 。 

npm 要 求 Node 项 目 所 在 的 目录 下 有 一 个 package.json 文件 。 创 建 package.json 文件 的 最 简单 
方法 是 使 用 npm。 在 命令 行 中 输入 下 面 这 些 命令 : 

mkdir example-project 

cd example-project 

npm init -y 

打开 packagejson， 你 会 看 到 简单 的 JSON 格式 的 项 目 描述 信息 。 如 果 你 现在 用 带 有 参数 
--save 的 npm 命令 从 npm 网 站 上 安装 一 个 包 ， 它 会 自动 更 新 你 的 package.json 文件 。 试 着 输入 
npm install, 或 简写 为 npm i: 

npm i --save express 

打开 package.json， 应 该 会 看 到 dependencies 属性 下 面 新 增加 的 sxpress。 另 外 , 看 一 下 
node_ modules 文件 夹 ， 你 会 看 到 新 创建 的 express 目录 。 里 面 是 刚 安装 的 那个 版 本 的 Express。 你 
也 可 以 用 --global 参数 做 全 局 安装 。 应 尽 可 能 地 将 包 安装 在 项 目 里 ， 但 对 于 用 在 Node JavaScript 
代码 之 外 的 命令 行 工 具 ， 全 局 安装 更 合适 。 比 如 用 npm 安装 命令 行 工具 ESLint 时 ， 我 们 采用 全 
局 安装 。 

开始 用 Node 之 后 ， 你 会 经 常用 到 来 自 npm 的 包 。 另 外 ，Node 还 自 带 了 很 多 非常 实用 的 库 ， 
统称 为 核心 模块 ， 接 下 来 我 们 就 去 看 一 下 。 


1.4.2 ”核心 模块 


Node 的 核心 模块 就 相当 于 其 他 语言 的 标准 库 ， 它 们 是 编写 服务 器 端 JavaScript 所 需 的 工具 。 
大 多 数 服务 器 端 开 发 人 员 都 知道 ，JavaScript 标准 本 身 没 有 任何 处 理 网 络 的 东西 ， 甚 至 连 处 理 文 
件 VO 的 东西 都 没有 。Node 以 最 少 的 代码 给 它 加 上 了 文件 和 TCP/IP 网 络 功能 ， 使 其 成 为 了 一 个 
可 用 的 服务 器 端 编程 语言 。 

1. 文件 系统 

Node 不 仅 有 文件 系统 库 (fs、path )、TCP 客户 端 和 服务 端 库 (net )、HTTP 库 ( http 和 https ) 
和 域名 解析 库 ( dns )， 还 有 一 个 经 常用 来 写 测试 的 断言 库 (assert )， 以 及 一 个 用 来 查询 平台 信息 
的 操作 系统 库 (os )。 

Node 还 有 一 些 独 有 库 。 事 件 模 块 是 一 个 处 理事 件 的 小 型 库 ，Node 的 大 多 数 API 都 是 以 它 为 
基础 来 做 的 。 比 如 说 ， 流 模块 用 事件 模块 提供 了 一 个 处 理 流 数 据 的 抽象 接口 。 因 为 Node 中 的 所 
有 数据 流 用 的 都 是 同样 的 API， 所 以 你 可 以 很 轻松 地 组 装 出 软件 组 件 。 如 果 你 有 一 个 文件 流 读 取 
器 , 就 可 以 很 方便 地 把 它 跟 压缩 数据 的 zlib 连接 到 一 起 , 然后 这 个 zlib 再 连接 一 个 文件 流 写 人 器， 
从 而 形成 一 个 文件 流 处 理 管道 。 

在 下 面 这 段 代码 中 ， 我 们 用 Node 的 fs 模块 创建 了 读 和 写 流 ， 然 后 把 它们 通过 另外 一 个 流 
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( gzip ) 连接 起 来 传输 数据 ， 就 这 个 例子 而 言 ， 就 是 压缩 。 
代码 清单 1-1 使 用 核心 模块 和 流 


const fs = require('fs'); 

const zlib = require('zlib'); 

const gzip = zlib.createGzip(); 

const outStream = fs.createWriteStream('output.js.gz'); 





fs.createReadStream('./node-stream.js') 
.pipe (gzip) 
.pipe (outStream); 


2. 网 络 

曾几何时 , 我 们 总 是 说 创建 一 个 简单 的 HTTP 服务 器 才 是 Node 真正 的 Hello World。 在 Node 
中 搭 一 个 服务 器 只 需要 加 载 http 模块 , 然后 给 它 一 个 函数 。 这 个 函数 有 两 个 参数 , 即 请 求 和 响应 。 
你 可 以 在 自己 的 终端 中 运行 一 下 这 段 代码 。 


代码 清单 1-2 ”用 Node 的 http 模块 写 的 Hello World 
const http 
const port 




















require('http'); 
8080; 


const server = http.createServer((req, res) => { 
res.end('Hello, world.'); 
J 


server.listen(port, () => { 
console.log('Server listening on: http://localhost:%s', port); 
中) 


将 上 面 的 代码 保存 到 hello . 文件 中 , 用 nogde hello.js 运行 它 。 访问 http://localhost:8080， 
你 应 该 能 看 到 第 4 行 的 问候 信息 。 

Node 的 核心 模块 精炼 强悍 。 你 甚至 不 需要 用 npm 安装 任何 东西 就 可 以 用 这 些 模块 完成 很 多 
事情 。 可 以 参阅 Node 的 api 网 站 来 了 解 核心 模块 的 更 多 相关 信息 。 

最 后 一 个 内 置 工具 是 调试 器 。 下 一 节 我 们 将 会 通过 一 个 例子 来 介绍 它 


1.4.3 ”调试 器 
Node 自 带 的 调试 器 支持 单 步 执行 和 REPL ( 读 取 -计算 -输出 -循环 )。 这 个 调试 器 在 工作 时 


会 用 一 个 网 络 协议 跟 你 的 程序 对 话 。 带 着 aebug 参数 运行 程序 ， 就 可 以 对 这 个 程序 开启 调试 器 。 
比如 要 调试 代码 清单 1-2 中 的 代码 : 


node debug hello.js 


然后 应 该 能 看 到 下 面 这 样 的 输出 : 


< Debugger listening on [::]:5858 
connecting to 127.0.0.1:5858 ... ok 
break in node-hnttp.js:1 
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> 1 const http = require('http'); 
2 Onst, port ss B080 
3 


Node 启动 了 这 个 程序 ， 并 连 到 5858 端口 上 对 它 进行 调试 。 你 可 以 输入 help 看 一 下 它 的 命 
令 , 然后 输入 命令 c 让 程序 继续 执行 。Node 启动 程序 时 总 是 把 它 置 于 break 状态 上 ， 所 以 在 你 
想 做 任何 事情 之 前 ， 总 要 先 让 它 继续 执行 。 

我 们 可 以 在 代码 中 的 任何 地 方 添加 aqebugger 语句 来 设置 断 点 。 遇 到 debugger 语句 后 ， 
调试 器 就 会 把 程序 停 住 ， 然 后 你 可 以 输入 命令 。 比 如 说 ， 你 写 了 一 个 REST API 来 为 新 用 户 创建 
账号 ， 但 发 现代 码 貌 似 没有 把 新 用 户 密 码 的 散 列 值 写 到 数据 库 里 。 你 可 以 在 User 类 的 save 方 
法 那里 加 一 个 aebugger， 然 后 单 步 执行 每 一 条 指令 ， 看 看 发 生 了 什么 。 
































交互 式 调试 
Node 支持 Chrome 调试 协议 。 如 果 要 用 Chrome 的 开发 者 工具 调试 一 段 脚 本 ， 可 以 在 运行 
程序 时 加 上 --inspect 参数 : 
node --inspect --debug-brk 
这 样 Node 就 会 启动 调试 器 ， 并 停 在 第 一 行 。 它 会 输出 一 个 URL 到 控制 台 ， 你 可 以 在 
Chrome 中 打开 这 个 URL， 然后 用 Chrome 的 调试 器 进行 调试 。Chrome 的 调试 器 可 以 一 行 行 地 
执行 代码 ， 还 能 显示 每 个 变量 和 对 象 的 值 。 这 要 比 在 代码 里 敲 console.1og 好 得 多 。 

















第 9 章 还 会 详细 讲解 调试 技术 。 如 果 你 现在 就 想 试 一 下 ， 那 么 最 好 的 人 手 点 是 Node 调试 器 
手册 。 

前 面 我 们 介绍 了 Node 的 工作 机 理 ， 以 及 它 给 开发 人 员 所 提供 的 工具 。 现 在 你 可 能 很 想 知 
道 , 人 们 在 生产 环境 中 用 Node 都 做 了 什么 样 的 程序 。 接 下 来 我 们 就 看 看 可 以 用 Node 实现 的 几 
种 程序 。 


1.5 三 种 主流 的 Node 程序 


Node 程序 主要 可 以 分 成 三 种 类 型 : Web 应 用 程序 、 命 令 行 工 具 和 后 台 程 序 、 桌 面 程序 。 提 
供 单 页 应 用 的 简单 程序 、REST 微服 务 以 及 全 栈 的 Web 应 用 都 属于 Web 应 用 程序 。 你 可 能 已 经 使 
用 过 用 Node 写 的 命令 行 工 具 了 , 比如 npm、Gulp 和 Webpack。 后 台 程 序 就 是 后 台 服 务 , 比如 PM2 
进程 管理 器 。 桌 面 程序 一 般 是 用 Electron 框架 写 的 软件 ，Electron 用 Node 作为 基于 Web 的 桌面 
应 用 的 后 台 。Atom 和 Visual Studio Code 文本 编辑 器 都 属于 这 一 类 。 




































































1.5.1 ”Web 应 用 程序 


为 Node 是 服务 器 端 JavaScript 平 台 ， 所 以 用 它 搭建 Web 应 用 程序 是 理所当然 的 事情 。 婚 
然 客户 端 和 服务 器 端 用 的 都 是 JavaScript， 代 码 难 免 会 有 在 这 两 种 环境 里 重用 的 机 会 。Node Web 
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应 用 一 般 是 用 Express 这 样 的 框架 写 的 。 第 6 章 介 绍 了 几 个 主要 的 Node 服务 器 端 框 架 , 多 
门 介 绍 了 Express 和 Connect， 第 8 章 是 Web 应 用 程序 模板 。 

你 可 以 通过 创建 一 个 新 目录 ， 然 后 在 里 面 安装 Express 模板 ， 来 快速 创建 一 个 Express Web 
应 用 程序 : 

mkdir hello_express 

cd hello_express 

npm init -y 

npm i express --save 


接 下 来 把 下 面 的 JavaScript 代码 存 到 serverjs 中 。 


代码 清单 1-3 一 个 Node Web 应 用 程序 
const express = require('express'); 
const app = express(); 


7 章 专 


























app get(/", (redq; Lesy, Ss> 江 
res.send('Hello World!'); 

ee 0 SE 

console.1log('Express web app on localhost:3000'); 

}); 

现在 输入 npm _ start， 局 动 这 个 监听 端口 3000 的 Node Web 服务 器 。 在 浏览 器 中 打开 
http://localhost:3000 ， 就 能 看 到 res . seng 那 行 代码 发 回 的 文本 。 

在 前 端 开 发 的 世界 中 ，Node 也 在 发 挥 着 重要 作用 ， 因 为 它 是 进行 语言 转译 的 主要 工具 ， 比 
如 从 TypeScript 到 JavaScript。 转 译 器 将 一 种 高 级 语言 编译 成 另外 一 种 高 级 语言 ， 传 统 的 编译 器 
则 将 一 种 高 级 语言 编译 成 一 种 低级 语言 。 第 4 章 将 会 专门 介绍 前 端 构建 系统 ， 到 时 候 你 会 看 到 
npm 脚本 、Gulp 和 Webpack 的 用 法 。 

并 不 是 所 有 的 Web 开发 都 会 涉及 Web 应 用 的 构建 。 有 时 候 ， 在 重建 一 个 网 站 时 ， 你 需要 把 
数据 从 老 网 站 上 扒 出 来 。 我 们 专门 加 了 个 附录 也 来 讲 网 页 抓 取 ， 以 便 展示 如 何 用 Node 的 JavaScript 
运行 平台 处 理 文档 对 象 模型 (DOM )， 同 时 也 展示 了 如 何在 Express Web 应 用 这 个 舒适 区 之 外 使 
用 Node。 如 果 你 只 是 想 快速 地 构建 一 个 简单 的 Web 应 用 , 第 3 章 为 我 们 提供 了 一 个 完整 的 Node 
Web 应 用 程序 搭建 教程 。 



























































1.5.2 ”命令 行 工 具 和 后 台 程 序 


Node 可 以 用 来 编写 命令 行 工 具 ， 比 如 JavaScript 开发 人 员 所 用 的 进程 管理 器 和 JavaScript 转 
译 器 。 它 也 可 以 作为 一 种 方便 的 方式 来 编写 其 他 操作 的 命令 行 工 具 ， 比 如 图 片 转 换 、 控 制 媒体 文 
件 播 放 的 脚本 等 。 

你 可 以 试 一 下 下 面 这 个 例子 。 创 建 一 个 名 为 clijs 的 新 文件 ， 添 加 如 下 代码 : 


const [nodePath, scriptPath, name] = process.argyv; 
console.log('Hello', name); 
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用 noae cli.jsyourName 运行 这 个 脚本 ， 你 会 看 到 Hello yourName。 这 用 到 了 ES2015 
的 解构 , 它 会 从 process .argv 中 拉 取 第 三 个 参数 。 所 有 Node 程序 都 可 以 访问 process 对 象 ， 
这 是 用 户 向 程序 中 传递 参数 的 基础 。 

Node 命令 行程 序 还 可 以 做 其 他 事情 。 如 果 在 程序 开头 的 地 方 加 上 #:! ， 并 赋予 其 执行 许可 
(chmoqd +x cli.js)，shell 就 可 以 在 调用 程序 时 使 用 Node。 也 就 是 说 可 以 像 运行 其 他 shell 脚 
本 那样 运行 Node 程序 。 在 类 Unix 系统 中 用 下 面 这 样 的 代码 : 

#!/usr/bin/env node 

这 样 你 就 可 以 用 Node 代替 shell 脚本。 也 就 是 说 Node 可 以 跟 其 他 任何 命令 行 工 具 配 合 ， 包 
括 后 台 程 序 。Node 程序 可 以 由 cron 调用 ， 也 可 以 作为 后 台 程 序 运行 。 

如 果 你 觉得 这 一 切 都 很 陌生 ,不 用 担心 。 第 11 章 将 会 介绍 如 何 编写 命令 行 工 具 ， 展 示 Node 
在 这 种 程序 上 的 实力 。 比 如 说 ， 大 量 使 用 流 作 为 通用 API 的 命令 行 工具 ， 而 流 处 理 是 Node 最 强 
大 的 功能 之 一 。 

































































1.5.3 ”桌面 程序 


如 果 你 用 过 Atom 或 Visual Studio Code 文本 编辑 带 ， 那 就 用 过 Node。Electron 框架 用 Node 
做 后 台 ， 所 以 只 要 需要 访问 硬盘 或 网 络 ，Electron 就 会 用 到 Node。Electron 还 用 Node 来 管理 依 
赖 项 ， 也 就 是 说 你 可 以 用 npm 往 Electron 项 目 里 添加 包 。 

如 果 你 现在 就 想 试 一 下 ， 可 以 复制 Electron 的 存储 库 并 启动 一 个 应 用 程序 : 

git clone https://github.com/electron/electron-gquick-start 

cd electron-quick-start 


npm install && npm start 
curl] localhost:8081 


如 果 你 想 要 了 解 如 何 用 Electron 写 程序 ， 可 以 翻 到 第 12 章 看 一 下 。 


1.5.4 适合 Node 的 应 用 程序 


我 们 已 经 看 过 一 些 能 用 Node 搭建 的 应 用 程序 了 ,但 Node 擅长 的 领域 不 止 于 此 。Node 一 般 
用 来 创建 实时 的 Web 应 用 ， 这 几乎 无 所 不 包 ， 从 直接 面 对 用 户 的 聊天 服务 器 到 采集 分 析 数 据 的 
后 台 程 序 都 属于 此 类 。 在 JavaScript 中 ,函数 是 一 等 对 象 ，Node 又 有 内 建 的 事件 模型 ， 所 以 用 它 
来 写 异步 实时 程序 比 用 其 他 脚本 语言 更 自然 。 

如 果 你 要 搭建 传统 的 模型 -视图 -控制 器 (MVC ) Web 应 用 ， 用 Node 也 很 适合 。Ghost 等 一 
些 流行 的 博客 引擎 就 是 用 Node 搭建 的 。 在 搭建 这 几 种 类 型 的 Web 应 用 程序 方面 ，Node 是 一 个 
经 过 实践 检验 的 平台 。 虽 然 开发 风格 跟 用 PHP 的 WordPress 不 同 , 但 Ghost 支持 的 功能 是 类 似 的 ， 
包括 模板 和 多 用 户 管理 区 。 

Node 还 能 做 一 些 用 其 他 语言 很 难 做 到 的 事情 。 它 是 基于 JavaScript 的 ， 所 以 在 Node 中 能 
行 浏 览 器 中 的 JavaScript。 复 杂 的 客户 端 应 用 可 以 经 过 改造 在 Node 服务 器 上 运行 , 让 服务 器 进 
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预 泻 染 ， 从 而 加 快 页 面 在 浏览 器 中 的 泻 染 速度 ， 也 有 利于 搜索 引擎 进行 索引 。 | 
最 后 ， 如 果 你 想 要 搭建 一 个 桌面 端 或 移动 端 应 用 ， 建 议 试 一 下 Electron， 它 也 是 由 Node 支 

撑 起 来 的 。 现 在 Web 用 户 界 面 的 体验 跟 桌 面 端 应 用 一 样 丰富 ，Electron 桌面 端 应 用 足以 抗衡 本 地 

Web 应 用 , 还 能 缩短 开发 时 间 。Electron 支持 三 种 主流 操作 系统 ， 所 以 你 可 以 在 Windows 、Linux 

和 macOS 上 重用 这 些 代码 。 








1.6 总 结 


/和 一口 














口 Node 是 用 来 搭建 JavaScript 应 用 程序 的 平台 ， 有 基于 事件 和 非 阻 塞 的 特性 。 
口 V8 被 用 作 JavaScript 运行 时 。 

D libuv 是 提供 快速 、 跨 平台 、 非 阻塞 IO 的 本 地 库 。 

口 被 称 为 核心 模块 的 Node 标准 库 很 精巧 ， 为 JavaScript 添加 了 磁盘 LO。 

口 Node 自 带 了 一 个 调试 器 和 一 个 依赖 管理 器 (npm )。 

口 Node 可 以 用 于 搭建 Web 应 用 程序 、 命 令 行 工 具 ， 甚 至 桌面 程序 。 
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本 章 内 容 

口 用 模块 组 织 代码 

口 用 回调 处 理 一 次 性 事件 

口 用 事件 发 射 器 处理 重 复 性 事件 
口 实现 串 行 和 并 行 的 流程 控制 
口 使 用 流程 控制 工具 











与 大 多 数 开源 平台 不 同 ，Node 设置 起 来 很 容易 ， 对 内 存 和 硬盘 空间 要 求 不 高 ， 也 不 需要 复 
杂 的 集成 开发 环境 或 构建 系统 。 但 对 于 刚 起 步 的 新 手 来 说 ,掌握 一 些 基础 知识 会 有 很 大 帮助 。 本 
章 要 解决 摆 在 Node 开发 新 手 面前 的 两 个 难题 : 
口 如 何 组 织 代码 ; 
口 如 何 实现 异步 编程 。 
本 章 会 介绍 几 种 重要 的 异步 编程 技术 ， 让 你 能 牢 牢 控 制程 序 的 执行 。 包括: 
口 如 何 二 总 二 天 事件 ; 
口 如 何 处 理 重复 性 事件 ; 
口 如 何 让 异步 逻辑 顺序 执行 。 

不 过 我 们 要 先 讲 一 下 如 何 用 模块 组 织 代码 。 模 块 是 Node 的 一 种 代码 组 织 和 包装 方式 ， 让 代 
码 更 容易 重用 。 


2.1 Node 功能 的 组 织 及 重用 


在 创建 程序 时 ， 不管 是 用 Node 还 是 其 他 工具 ， 基 本 不 可 能 把 所 有 代码 都 放 到 一 个 文件 中 。 
当 出 现 这 种 情况 时 ， ee 将 包含 大 量 代码 的 单个 文件 分 解 成 
多 个 文件 ， 如 图 2-1 所 示 。 
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Utilities 
lib/utilityFunctions.js 
Commands 
index.js lib/commands.js ] 
所 有 代码 都 在 一 个 文件 中 相关 的 逻辑 一 起 放 在 单独 的 文件 中 
图 2-1 与 全 部 存放 在 一 个 长 文件 中 的 代码 相 比 ， 用 目录 和 单独 的 文件 组 织 起 来 的 代码 
更 容易 查找 


在 某 些 语言 中 ， 比 如 PHP 和 Ruby， 整 合 男 一 个 文件 (我 们 称 之 为 “included” 文 件 ) 中 的 人 逻 
辑 , 可 能 意味 着 在 被 引入 文件 中 执行 的 逻辑 会 影响 全 局 作用 域 。 也 就 是 说 , 被 引入 文件 创建 的 任 
何 变量 和 声明 的 任何 函数 ， 都 可 能 会 覆盖 包含 它 的 应 用 程序 所 创建 的 变量 和 声明 的 函数 。 
假设 用 PHP 写 程序 ， 可 能 会 有 下 面 这 种 逻辑 : 
function uppercase_trim(Stext) { 
return trim(strtoupper ($text)); 


} 
include('string_handlers.php'); 


如 果 string_handlers.php 文件 也 定义 了 一 个 uppercase_trim 函数 ， 你 会 收 到 一 条 错误 消息 : 











Fatal error: Cannot redeclare uppercase trim() 

在 PHP 中 可 以 用 命名 空间 避免 这 个 问题 ，Ruby 通过 模块 也 提供 了 类 似 的 功能 。 但 Node 的 
做 法 是 不 给 你 不 小 心 污染 全 局 命名 空间 的 机 会 。 

PHP 命名 空间 和 Ruby 模块 PHP 命名 空间 在 它 的 手册 上 有 相关 论述 。Ruby 模块 

在 Ruby 文 档 中 有 解释 说 明 。 

Node 模块 打包 代码 是 为 了 重用 ， 但 它们 不 会 改变 全 局 作用 域 。 比 如 说 ， 假 疫 你 正 用 PHP 开 
发 一 个 开源 的 内 容 管理 系统 (CMS )， 并 且 想 用 一 个 没有 使 用 命名 空间 的 第 三 方 API 库 。 这 个 库 
中 可 能 有 一 个 跟 你 的 程序 中 同名 的 类 , 除非 你 把 自己 程序 中 的 类 名 或 者 库 中 的 类 名 改 了 , 否则 这 
个 类 可 能 会 摘 垮 你 的 程序 。 可 是 修改 程序 中 的 类 名 可 能 会 让 那些 以 你 的 CMS 为 基础 构建 项 目的 
开发 人 员 遇 到 问题 。 如 果 修 改 那个 库 中 的 类 名 , 那么 每 次 更 新 程序 源码 树 中 的 那个 库 时 都 得 记 着 
青 改 一 次 。 解 决 命名 冲突 问题 最 好 的 办 法 是 从 根本 上 予以 避免 。 

Node 模块 允许 从 被 引入 文件 中 选择 要 其 露 给 程序 的 函数 和 变量 。 如 果 模 块 返 回 的 函数 或 变 
量 不 止 一 个 ， 那 它 可 以 通过 设 定 exports 对 象 的 属性 来 指明 它们 。 但 如 果 模 块 只 返回 一 个 函数 
或 变量 ， 则 可 以 设 定 module .exports 属性 。 图 2-2 展示 了 这 一 工作 机 制 。 
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redcuires 模 块 










S] 模块 


























在 require 期 间 返 回 的 sd 


module.exports 
或 exports 














module .exports 
或 


exports 


模块 逻辑 组 装 的 
module .exports 
或 exports 


图 2-2 组 装 moqule.exports 属性 或 exports 对 象 让 模块 可 以 选择 应 该 把 什么 跟 
程序 共享 





如 果 你 觉得 有 点 掌 ， 先 别 急 。 我 们 在 这 一 章 里 会 给 出 好 几 个 例子 。Node 的 模块 系统 避免 了 
对 全 局 作用 域 的 污染 ， 从 而 也 就 避免 了 命名 冲突 ， 并 简化 了 代码 的 重用 。 模块 还 可 以 发 布 到 npm 
( Node 包 管 理 器 ) 存储 库 中 ， 这 是 一 个 在 线 存 储 库 ， 收 集 了 已 经 可 用 并 且 要 跟 Node 社区 分 享 的 
Node 模块 ， 使 用 这 些 模块 没 必要 担心 某 个 模块 会 覆盖 其 他 模块 的 变量 和 函数 。 

为 了 帮 你 把 逻辑 组 织 到 模块 中 ,我 们 会 讨论 下 面 这 些 主题 : 
口 如 何 创 建 模块 ; 
口 模块 放 在 文件 系统 中 的 什么 地 方 ; 
口 在 创建 和 使 用 模块 时 要 意识 到 的 东西 。 
我 们 这 就 深入 到 Node 模块 系统 的 学 习 中 去 ， 开 始 一 个 新 的 Node 项 目 ， 然 后 创建 第 一 个 简 
单 的 模块 。 


2.2 ”开始 一 个 新 的 Node 项 目 


创建 新 的 Node 项 目 很 简单 : 创建 一 个 文件 来， 运行 npm init。 好 了 ! npm 命令 会 问 几 个 
问题 ， 一 直 回 答 yes 就 可 以 了 。 

下 面 是 一 个 完整 的 例子 : 

mkdir my_moudle 

cd my_moudle 

npm init -y 
参数 -y 表示 yes。 这样 npm 就 会 创建 一 个 全 部 使 用 默认 值 的 package.json 文件 。 如 果 你 想 要 更 多 
的 控制 权 ， 去 掉 参 数 -y， 你 就 能 看 到 npm 提出 的 一 系列 问题 , 包括 授权 许可 、 作 者 姓名 ， 等 等 。 
完成 之 后 看 一 下 package.json， 你 会 在 其 中 发 现 自己 提供 的 那些 答案 。 你 也 可 以 手动 编辑 ， 但 记 
得 必须 是 有 效 的 JSON。 

空 项 目 有 了 ， 可 以 创建 模块 了 。 
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创建 模块 


模块 既 可 以 是 一 个 文件 ， 也 可 以 是 包含 一 个 或 多 个 文件 的 目录 ， 如 图 2-3 所 示 。 如 果 模 块 是 
一 个 目录 , Node 通常 会 在 这 个 目录 下 找 一 个 叫 ndex,js 的 文件 作为 模块 的 入 口 ( 这 个 默认 设置 可 
以 重 写 ， 见 2.5 市 )。 | 












































1. 2. 
;5 my_module.js v a my_module 
5 index.js 




















图 2-3 ”Node 模块 可 以 用 文件 ( 例 1 ) 或 目录 ( 例 2) 创建 


典型 的 模块 是 一 个 包含 exports 对 象 属性 定义 的 文件 ， 这 些 属 性 可 以 是 任意 类 型 的 数据 ， 
比如 字符 串 、 对 象 和 函数 。 

为 了 演示 如 何 创建 基本 的 模块 , 我 们 在 一 个 名 为 currencyjs 的 文件 中 添加 一 些 做 货币 转换 的 
函数 。 这 个 文件 如 下 面 的 代码 清单 所 示 ， 其 中 有 两 个 函数 ， 分 别 对 加 元 和 美元 进行 互 换 。 


代码 清单 2-1 定义 一 个 Node 模块 (currencyjs ) 


const canadianDollar = 0.91; 



































f i T & 
unction roundTwo(amount) { canadianToUS 函数 设 定 在 exports 


模块 
return Math.round (amount 00) “L000 中 ， 所 以 引入 这 个 模块 的 代码 可 以 使 用 它 


exports.canadianToUS canadian => roundTwo(canadian * canadianDollar); 


exports.USToCanadian us => roundTwo(us / canadianDollar); 
USToCanadian 也 设 定 在 
exports 模块 中 


exports 对 象 上 只 设 定 了 两 个 属性 。 也 就 是 说 引入 这 个 模块 的 代码 只 能 访问 到 canaqian- 
ToUS 和 USToCanadian 这 两 个 困 数 。 而 变量 canadianDollar 作为 私有 变量 仅 作 用 在 
canadianToUS 和 USToCanadian 的 逻辑 内 部 ， 程 序 不 能 直接 访问 它 。 
使 用 这 个 新 模块 要 用 到 Node 的 require 函数 ， 该 函数 以 所 用 模块 的 路 径 为 参数 。Node 以 
同步 的 方式 寻找 模块 ， 定 位 到 这 个 模块 并 加 载 文件 中 的 内 容 。Node 查找 文件 的 顺序 是 先 找 核心 
模块 ， 然 后 是 当前 目录 ， 最 后 是 node_modules。 



























































关于 require 和 同步 |/O 
require 是 Node 中 少数 几 个 同步 JO 操作 之 一 。 因 为 经 常用 到 模块 ， 并 且 一 般 都 是 在 文 
件 顶 端 引 入 ， 所 以 把 require 做 成 同步 的 有 助 于 保持 代码 的 整洁 、 有 序 ， 还 能 增强 可 读 性 。 
但 在 IO 密集 的 地 方 尽 量 不 要 用 require。 所 有 同步 调用 都 会 阻塞 Node， 直 到 调用 完成 
才能 做 其 他 事情 。 比 如 你 正在 运行 一 个 HTTP 服务 器 ， 如 果 在 每 个 进入 的 请 求 上 都 用 了 
require, 就 会 遇 到 性 能 问题 。 所 以 require 和 其 他 同步 操作 通常 放 在 程序 最 初 加 载 的 地 方 。 
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下 面 这 个 是 test-currencyjs 中 的 代码 ， 它 require 了 currencyjs 模块 。 


代码 清单 2-2 引入 一 个 模块 ( test_currency.js ) 


使 用 currency 模块 的 用 路 径 ./ 表明 模块 跟 程 
canadianToUS 函数 序 脚本 放 在 同一 目录 下 
Const currency = require('./currency'); 


console.1og('50 Canadian dollars equals this amount of US dollars:'); 
console.log(currency.canadianToUS (50) ) ; 
console.1log('30 US dollars equals this amount of Canadian dollars:'); 
console.log(currency.USToCanadian (30)); 

使 用 currency 模块 的 


USToCanadian 函数 


引入 一 个 以 . /开头 的 模块 意味 着 ， 如 果 你 准备 创建 的 程序 脚本 test-currencyjs 在 currency_app 
目录 下 , 那 currency.js 模块 文件 ,如 图 2-4 所 示 , 应 该 也 放 在 currency_ app 目录 下 。 在 引入 时 ，.js 
扩展 名 可 以 忽略 。 如 果 没 有 指明 是 js 文件 ,Node 也 会 检查 json 文件 ，json 文件 是 作为 JavaScript 




















对 象 加 载 的 。 


currency_app 


test-currency.js 


1 





ein, /Ce me 


currency.js 


图 2-4 如 果 在 require 模块 时 把 ./ 放 在 前 面 ，Node 会 在 被 执行 程序 文件 所 在 的 目录 
下 寻找 这 个 模块 



































在 Node 定位 到 并 计算 好 你 的 模块 之 后 ，require 函数 会 返回 这 个 模块 中 定义 的 exports 





对 象 中 的 内 容 ， 然 后 你 就 可 以 用 这 个 模块 中 的 两 个 函数 做 货币 转换 了 。 








如 果 想 把 这 个 模块 放 到 子 目 录 中 ， 比 如 lib/， 只 要 把 require 语句 改 成 下 面 这 样 就 可 以 了 : 


const currency = require('./lib/currency'); 


组 装 模 块 中 的 exports 对 象 是 在 单独 的 文件 中 组 织 可 重用 代码 的 一 种 简便 方法 。 


2.3 用 module .exports 微调 模块 的 创建 











尽管 用 函数 和 变量 组 装 exports 对 象 能 满足 大 多 数 的 模块 创建 需要 ， 但 有 时 你 可 能 需 





不 同 的 模型 创建 该 模块 。 





要 用 


比如 说 , 前 面 创 建 的 那个 货币 转换 器 模块 可 以 改 成 只 返回 一 个 currency 构造 函数 , 而 不 是 





包含 两 个 函数 的 对 象 。 一 个 面向 对 象 的 实现 看 起 来 可 能 像 下 面 这 样 : 
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const Currency = require('./currency'); 

const canadianDollar = 0.91; 

const currency = new Currency (canadianDollar); 
console.log(currency.canadianToUS (50)); 


如 果 只 需要 从 模块 中 得 到 一 个 函数 ， 那 从 require 中 返回 一 个 函数 的 代码 要 比 返回 一 个 对 天 
象 的 代码 更 优雅 。 

要 创建 只 返回 一 个 变量 或 函数 的 模块 ， 你 可 能 会 以 为 只 要 把 exports 设 定 成 你 想 返回 的 东 
西 就 行 。 但 这 样 是 不 行 的 ， 因 为 Node 觉得 不 能 用 任何 其 他 对 象 、 函 数 或 变量 给 exports 赋值 。 
下 面 这 个 代码 清单 中 的 模块 代码 试图 将 一 个 函数 赋值 给 exports。 
代码 清单 2-3 ”这 个 模块 不 能 用 

class Currency { 

constructor(canadianDollar) { 


this.canadianDollar = canadianDollar; 


} 





























roundTwoDecimals (amount) { 
return Math.round(amount * 100) / 100; 


} 


canadianToUS (canadian) { 
return this.roundTwoDecimals (canadian * this.canadianDollar); 


} 


USToCanadian(us) { 
return this.roundTwoDecimals(us / this.canadianDollar); 


人 错误 , Node 不 允许 

exports = Currency; < 重 写 exports 

为 了 让 前 面 那个 模块 的 代码 能 用 ， 需 要 把 exports 换 成 module.exports。 用 module. 
exports 可 以 对 外 提供 单个 变量 、 函 数 或 者 对 象 。 如 果 你 创建 了 一 个 既 有 exports 又 有 
module .exports 的 模块 ， 那 它 会 返回 module .exports， 而 exports 会 被 忽略 。 

















导出 的 究竟 是 什么 

最 终 在 程序 里 导出 的 是 module.exports。exports 只 是 对 module.exports 的 一 个 全 
局 引用 ， 最 初 被 定义 为 一 个 可 以 添加 属性 的 空 对 象 。exports .myFunc 只 是 module.exports. 
myFunc 的 简写 。 

所 以 ， 如 果 把 exports 设 定 为 别 的 ， 就 打破 了 module.exports 和 exports 之 间 的 引用 
关系 。 可 是 因为 真正 导出 的 是 module .exports， 那 样 exports 就 不 能 用 了 ， 因 为 它 不 再 指向 
module.exports 了 。 如 果 你 想 保留 那个 链接 ， 可 以 像 下 面 这 样 让 module.exports 再 次 引用 
exports: 


module.exports = exports = Currency; 


根据 需要 使 用 exports 或 module.exports 可 以 将 功能 组 织 成 模块 ， 规 避 掉 程序 脚本 
一 直 增 长 所 产生 的 苏 端 。 
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2.4 用 node_modules 重用 模块 


要 求 模块 在 文件 系统 中 使 用 相对 路 径 存放 , 对 于 组 织 程序 特定 的 代码 很 有 帮助 , 但 对 于 想 要 
在 程序 间 共 享 或 跟 其 他 人 共享 代码 却 用 处 不 大 。Node 中 有 一 个 独特 的 模块 引入 机 制 ， 可 以 不 必 
知道 模块 在 文件 系统 中 的 具体 位 置 。 这 个 机 制 就 是 使 用 node_modules 目录 。 

前 面 那个 模块 的 例子 中 引入 的 是 . /currency。 如 果 省 略 ./， 只 写 currency，Node 会 遵照 
儿 个 规则 搜寻 这 个 模块 ， 如 图 2-5 所 示 。 


















































开始 在 程序 文件 同一 目录 下 查找 
















是 核心 模块 吗 ? 


模块 在 当前 
目录 下 的 
node modules 


目录 下 吗 ? 




















父 目 录 存 在 吗 ? 








模块 在 由 环境 变量 
NODE_PRTH 


指定 的 目录 下 吗 ? 














图 2-5 查找 模块 的 步骤 
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用 环境 变量 NODE_PATH 可 以 改变 Node 模块 的 默认 路 径 。 如 果 用 了 它 ， 在 Windows 中 
NODE_PATH 应 该 设置 为 用 分 号 分 隔 的 目录 列表 ， 在 其 他 操作 系统 中 则 用 冒号 分 隔 。 





























2.5 注意 事项 


尽管 Node 模块 系统 的 本 质 简单 直接 ， 但 还 是 有 两 点 需要 注意 一 下 。 

第 一 ， 如 果 模 块 是 目录 ， 在 模块 目录 中 定义 模块 的 文件 必须 被 命名 为 index.js， 除 非 你 在 这 
个 目录 下 一 个 叫 package.json 的 文件 里 特别 指明 。 要 指定 一 个 取代 index.js 的 文件 ，packagejson 
文件 里 必须 有 一 个 用 JavaScript 对 象 表示 法 (JSON ) 数据 定义 的 对 象 ， 其 中 有 一 个 名 为 main 的 
键 ， 指 明 模 块 目 录 内 主 文件 的 路 径 。 图 2-6 中 的 流程 图 对 这 些 规则 做 了 汇总 。 
























找到 模块 目录 






不 存在 









main 元 素 中 指定 
的 文件 存在 吗 ? 


有 package.json 
殉 件 吗 ? 


package.json 文 件 
中 有 main 元 素 吗 ? 

















有 indexjs 文 件 吗 ? 


用 index.js 文 件 定义 模块 


图 2-6 ” 当 模 块 目录 下 有 package.json 文件 时 ， 你 可 以 用 index.js 之 外 的 其 他 文件 定义 
自己 的 模块 


下 面 是 一 个 package.json 文件 的 例子 ， 它 指定 currency.js 为 主 文件 : 


{ 
"main": "currency.js" 


} 


第 二 ，Node 能 把 模块 作为 对 象 缓存 起 来 。 如 果 程 序 中 的 两 个 文件 引入 了 相同 的 模块 ， 第 一 
个 require 会 把 模块 返回 的 数据 存 到 内 存 中 , 这 样 第 二 个 require 就 不 用 再 去 访问 和 计算 模块 
的 源 文件 了 。 也 就 是 说 ， 在 同一 个 进程 中 用 require 加 载 一 个 模块 得 到 的 是 相同 的 对 象 。 假 设 
你 搭建 了 一 个 MVC Web 应 用 程序 ， 它 有 一 个 主 对 象 app。 你 可 以 设置 好 那个 app 对 象 ， 导 出 它 ， 
然后 在 项 目 中 的 任何 地 方 require 它 。 如 果 你 在 这 个 app 对 象 中 放 了 一 些 配置 信息 ， 那 你 就 可 
以 在 其 他 文件 中 访问 这 些 配置 信息 的 值 ， 假 定 目录 结 构 如 下 所 示 : 





用 main 元 素 中 指 
定 的 文件 定义 模块 
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project 
app.js 
models 
post.js 
一 -一 个 
图 2-7 展示 了 它 的 工作 原理 。 
app.js models/post.js 
const app = express(); const db = require('db'); 
se 人 const app = require('../app'); 
module.exports = app; db.connect (app.config('db')); 


内 存 中 的 app 对 象 实例 











{ config: { db: 'mysql://' } } 














图 2-7 在 Web 程序 中 共享 app 对 象 


熟悉 Node 模块 系统 最 好 的 办 法 是 自己 动手 试 一 试 ， 亲 目 验 证 一 下 本 节 所 描述 的 Node 的 行 
为 。 在 对 模块 的 工作 机 制 有 了 基本 的 认识 后 ， 接 下 来 学 习 异 步 编程 技术 。 


2.6 ”使 用 异步 编程 技术 


如 果 你 做 过 Web 前 端 程 序 ， 并 且 遇 到 过 界面 事件 〈 比 如 鼠标 点 击 ) 触发 的 逻辑 ， 那 你 就 做 
过 异步 程序 。 服 务 端 异 步 编程 也 一 样 : 事件 发 生 会 触发 响应 逻辑 。 在 Node 的 世界 里 流行 两 种 响 
应 逻辑 管理 方式 : 回调 和 事件 监听 。 

回调 通 党 用 来 定义 一 次 性 响应 的 逻辑 。 比 如 对 于 数据 库 查 询 , 可 以 指定 一 个 回调 函数 来 确定 
如 何 处 理 查 询 结果 。 这 个 回调 函数 可 能 会 显示 数据 库 查 询 结果 , 根据 这 些 结果 做 些 计算 ， 或 者 以 
查询 结果 为 参数 执行 男 一 个 回调 函数 。 

事件 监听 器 本 质 上 也 是 一 个 回调 ,不 同 的 是 , 它 跟 一 个 概念 实体 (事件 ) 相关 联 。 例 如 ， 当 
有 人 在 浏览 器 中 点 击 鼠 标 时 ， 鼠 标点 击 就 是 一 个 需要 处 理 的 事件 。 在 Node 中 ， 当 有 HTTP 请 求 
过 来 时 ，HTTP 服务 器 会 发 出 一 个 request 事件 。 你 可 以 监听 那个 request 事件 ， 并 添加 一 些 
响应 逻辑 。 在 下 面 这 个 例子 中 ， 因 为 用 EventEmitter.prototype.on 方法 在 服务 器 上 绑 定 了 
一 个 监听 器 ， 所 以 每 当 有 request 事件 发 出 时 ， 服 务 器 就 会 调用 handleRequest 限 数 : 

server.on('request', handleRequest) 

一 个 Node HTTP 服务 器 实例 就 是 一 个 事件 发 射 器 ， 一 个 可 以 继承 、 能 够 添加 事件 发 射 及 处 
理 能 力 的 类 ( EventEmitter )。Node 的 很 多 核心 功能 都 继承 自 Event Emitter， 你 也 能 创建 自 
己 的 事件 发 射 器 。 

Node 有 两 种 常用 的 响应 逻辑 组 织 方式 ， 我 们 刚才 用 了 其 中 一 种 ， 接 下 来 要 了 解 一 下 它 的 工 
作 机 制 : 
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口 如 何 用 回调 处 理 一 次 性 事件 ; 

口 如 何 用 事件 监听 需 响 应 重复 性 事件 ; 

口 异步 编程 的 几 个 难点 。 

先 来 看 这 个 最 常用 的 异步 代码 编写 方式 : 使 用 回调 。 


2.7 用 回调 处 理 一 次 性 事件 


回调 是 一 个 函数 ， 它 被 当 作 参 数 传 给 异步 函数 ， 用 来 描述 异步 操作 完成 之 后 要 做 什么 。 回 调 
在 Node 开发 中 用 得 很 频繁 ， 比 事件 发 射 器 用 得 多 ， 并 且 用 起 来 也 很 简单 。 
为 了 演示 回调 的 用 法 ， 我 们 来 做 一 个 简单 的 HTTP 服务 器 ， 让 它 实 现 如 下 功能 : 
口 异步 获取 存放 在 JSON 文件 中 的 文章 的 标题 ; 
口 异步 获取 简单 的 HTML 模板 ; 
口 把 那些 标题 组 装 到 HTML 页 面 里 ; 
口 把 HTML 页 面 发 送 给 用 户 。 
最 终结 果 如 图 2-8 所 示 。 



















































































© @ '[ localhost:8000 x A 


< CGC © localhost:8000 


Latest Posts 


。 Kazakhstan is a huge country... what goes on there? 
e。 This weather is making me craaazy 
。 My neighbor sort of howls at night 


























图 2-8 来 自 Web 服务 器 的 HTML 响应 ， 从 JSON 文件 中 获取 标题 并 返回 一 个 Web 页 画 
JSON 文件 ( titles.json ) 会 被 格式 化 成 一 个 包含 文章 标题 的 字符 串 数 组 ， 内 容 如 下 所 示 。 


SEE 今 立 兰 标 
代码 清单 2-4 ”一 个 包含 文章 标题 的 列表 
[ 
"Kazakhstan is a huge country... what goes on there?", 
"This weather is making me craaazy", 
"My neighbor sort of howls at night" 
] 


HTML 模板 文件 ( template.html ) 如 下 所 示 ， 结 构 很 简单 ， 可 以 插入 博客 文章 的 标题 。 
代码 清单 2-5 ”用 来 演 染 博客 标题 的 HTML 模板 


<!ldoctype html> 
<html> 
<head></head> 
<body> 
<hl>Latest Posts</hl> 
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<ul><1i>%</1i></ul> 人 < 一 % 会 被 替换 
</body> 为 标题 
</html> 


获取 JSON 文件 中 的 标题 并 演 染 Web 页 面 的 代码 妇 


0 下 所 示 ( blog_recent.js )。 


代码 清单 2-6 在 简单 的 程序 中 使 用 回调 的 例子 
const http = require('http'); i i 
const fs = require('fs'); 创建 HTTP 服务 器 并 用 回调 定义 
http.createServer((req, res) => { 了 响应 逻辑 
if (req.url == '/') { 
fs.readFile('./titles.json', (err, data) => { Se A 
if (err) { 如 果 出 错 , 输出 错误 读 取 dace 
console.error (err); 日 志 , 并 给 客户 端 返 义 如 何 处 理 其 中 的 内 容 
res.end('Server Error'); 回 “Server Error’ 
} else { 
从 JSON 文本 const titles = JSON.parse (data.toString()); 


fs.readFile('./template.html', (err, 
if (err) { 
console.error (err); 
res.end('Server Error'); 
} else { 


const tmpl 


中 解析 数据 


data.toString(); 


data) { 


=> 


a 读 取 HTML 模板 , 并 
在 加 载 完成 后 使 用 
回调 


const html = tmp1.replace('g'，titles.join('</11><11>'))， 
组 装 HTML 页 面 res.writeHead(200, { 'Content-Type': 'text/html' }); 
以 显示 博客 标题 res.end (html); < 
} 将 HTML 页 面 
} 发 送 给 用 户 
这 
} 
} LISCEert(8000% "T27080%L ) > 
这 个 例子 中 的 回调 能 套 了 三 层 : 
http.createServer((req, res) => { 
fs.readFile('./titles.json', (err, data) => { 
fs.readFile('./template.html', (err, data) => { 


三 层 还 算 可 以 , 但 回调 层 数 越 多 , 代码 看 起 来 越 天 
制 一 下 回调 的 内 套 层级 。 如 果 把 每 一 层 回调 内 套 的 处 到 





I 
a 




















L, 重 构 和 测试 起 来 也 越 困 难 ， 所 以 最 好 限 
做 成 命名 函数 , 虽然 表示 相同 逻辑 所 用 的 











代码 变 多 了 ,但 维护 、 测 试 和 重 构 起 来 会 更 容易 。 下 面 的 代码 功能 跟 代 码 清单 2-6 中 的 一 样 。 


代码 清单 2-7 创建 中 间 函 数 以 减少 胖 套 的 例子 








const http = require('http'); 
const fs = require('fs'); 客户 端 请 求 一 开 
http.createServer((req, res) => { < | 始 会 进 到 这 里 

getTitles (res) ; 了 一 控制 权 转交 给 了 
}D) LEenm(d000 TLE, :ONO EY) getTitles 
function getTitles(res) { re 

fs. et './titles.json', (err, data) => { 2 获取 标题 ， 并 将 控制 权 


转交 给 getTemplate 
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i 
hadError (err, res); 


} else { 
getTemplate(JSON.parse(data.toSstring()), res); 
} 
}) 
L 
function getTemplate(titles, res) { < getTemplate 读 取 模 板 文件 ， 
fs.readFile('./template.html', (err, data) => { 并 将 控制 权 转交 给 formatHtml 


工 生 (ELE A 
hadError (err, res); 


} else { 
formatHtml (titles, data.toString(), res); 
} formatHtml 得 到 标题 
区 和 模板 ， 泻 染 一 个 响应 
} 给 客户 端 
function formatHtml (titles, tmpl, res) { 
const html = tmpl.replace('%', titles.join('</l1i><1i>')); 
res.writeHead(200, {'Content-Type': 'text/html'}) 


res.end (html); 
} 


function hadError(err, res) { 如 果 这 个 a de hadError 
Le ErrORSrE) 会 将 错误 输出 到 控制 台 , 并 给 客户 端 返 
res.end('Server Error'); 回 “Server Error” 


你 还 可 以 用 Node 开发 中 的 另 一 种 惯用 法 来 减少 由 if/else 引起 的 舱 套 : 尽早 从 函数 中 返 
回 。 下 面 的 代码 清单 功能 跟前 面 一 样 , 但 通过 尽早 返回 的 做 法 避免 了 进一步 的 葵 套 。 它 还 明确 表 
示 出 了 函数 不 应 该 继续 执行 的 意思 。 


代码 清单 2-8 ”通过 尽早 返回 减少 胖 套 的 例子 


const http = require('http'); 

const fs = require('fs'); 

http.createServer((req, res) => { 
getTitles (res); 

}) iStCenta000, TT272080. Ty 

function getTitles(res) { 








fs.readFile('./titles.json', (err, data) => { 
if., (errt). returnm hadhrror (SEE 于 es) < 一 在 这 里 不 再 创建 一 个 else 分 
getTemplate(JSON.parse (data.toSstring()), res); 支 ， 而 是 直接 return， 因 为 
2 如 果 出 错 的 话 , 也 没 必要 继续 
2 执行 这 个 函数 了 
function getTemplate(titles, res) { 
fs.readFile('./template.html', (err, data) => { 
if (err) return hadError(err, res); 
formatHtml (titles, data.toString(), res); 


上 

; 

function formatHtml (titles, tmpl, res) { 
const html = tmpl.replace('%', titles.join('</l1i><1i>')); 
res.writeHead(200, { 'Content-Type': 'text/html'}); 
res.end (html); 

} 
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function hadError(err, res) { 
console.error (err); 
res.end('Server Error'); 


} 
你 已 经 学 过 如 何 用 回调 为 一 次 性 任务 定义 响应 了 ， 比 如 上 例 中 的 读 取 文件 和 响应 Web 服务 


器 请 求 ， 接 下 来 我 们 学 一 学 如 何 用 事件 发 射 器 组 织 事件 。 


- 





Node 的 异步 回调 惯例 

Node 中 的 大 多 数 内 置 模 块 在 使 用 回调 时 都 会 带 两 个 参数 : 第 一 个 用 来 放 可 能 会 发 生 的 错 
第 二 个 用 来 放 结 果 。 错 误 参 数 经 常 缩写 为 err。 
下 面 这 个 是 常用 的 函数 签名 的 典型 示例 : 
CO Pe Rene ee 
fsa ile /el Son Grr cat) = 

if (err) throw err; 

// 如 果 没 有 错误 发 生 ， 则 对 数据 进行 处 理 
本 


2.8 ”用 事件 发 射 器 处 理 重复 性 事件 


事件 发 射 器 会 触发 事件 ,并 且 在 那些 事件 被 触发 时 能 处 理 它们 。 一 些 重要 的 Node API 组 件 ， 





比如 HTTP 服务 器 、TCP 服务 器 和 流 , 都 被 做 成 了 事件 发 射 器 。 你 也 可 以 创建 自己 的 事件 发 射 器 。 





我 们 之 前 说 过 , 事件 是 通过 监听 器 进行 处 理 的 。 监 听 器 是 跟 事件 相关 联 的 、 当 有 事件 出 现时 





就 会 被 触发 的 回调 函数 。 比 如 Node 中 的 TCP socket， 它 有 一 个 aata 事件 ， 每 当 socket 中 有 新 
数据 时 就 会 触发 : 


socket .on('data', handleData); 


我 们 看 一 下 用 aata 事件 创建 的 echo 服务 右 。 


2.8.1 事件 发 射 器 示例 





echo 服务 器 就 是 一 个 处 理 重复 性 事件 的 简单 例子 ， 当 你 给 它 发 送 数据 时 ， 它 会 把 数据 发 回来 ， 





如 图 2-9 所 示 。 


QANN 2. Shell 
Last login:; Sun Nov 27 15:08:28 on ttys000 


0 


Mike-Cantelons-MacBook|~$ telnet 127.0.0.1 8888 
Trying 127.0.0.1... 

Connected to localhost. 

Escape character is 'A]'. 

Line one 





图 2-9 回 送 发 送 给 它 的 数据 的 echo 服务 器 
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下 面 的 代码 清单 实现 了 一 个 echo 服务 器 。 当 有 客户 端 连 接 上 来 时 ， 它 就 会 创建 一 个 socket。 
socket 是 一 个 事件 发 射 句 ， 可 以 用 on 方法 添加 监听 噩 响应 aata 事件 。 只 要 socket 上 有 新 数据 
过 来 ， 就 会 发 出 这 些 aata 事件 。 


代码 清单 2-9 用 on 方法 响应 事件 


const net = require('net'); 
当 读 这 吕 
const server = net.createServer(socket => { 当 读 取 到 新 数据 时 
4 处 理 的 aata 事件 


socket.on('data', data => { 
socket .write(data); = es 
三 | 
)) ; 人 
) ) ; 区 个 渍 


server.listen(8888); 


用 下 面 这 条 命令 可 以 运行 echo 服务 器 : 





node echo_server.js 

echo 服务 器 运行 起 来 之 后 ， 你 可 以 用 下 面 这 条 命令 连 上 去 : 

telnet 127.0.0.1 8888 

每 次 通过 telnet 会 话 把 数据 发 送 给 服务 器 ， 数 据 就 会 传 回 到 telnet 会 话 中 。 
Windows 上 的 Telnet 微软 的 Windows 操作 系统 中 可 能 没 装 telnet， 你 得 自己 装 。 

TechNet 上 有 各 版 本 Windows 下 的 安装 指南 。 




















2.8.2 ”响应 只 应 该 发 生 一 次 的 事件 


监听 噩 可 以 被 定义 成 持续 不 断 地 响应 事件 ， 如 前 面 例子 所 示 , 也 能 被 定义 成 只 响应 一 次 。 下面 
的 代码 用 了 once 方法 ， 对 前 面 那个 echo 服务 器 做 了 修改 ， 让 它 只 回应 第 一 次 发 送 过 来 的 数据 。 


代码 清单 2-10 用 once 方法 响应 单 次 事件 





const net = fedquire('net ') ; 
const server = net.createServer(socket => { 
socket.once('data', data = < 一 一 
socket 0 于 aata 事件 只 
被 处 理 一 次 


9) 
} 


server.listen(8888); 


2.8.3 创建 事件 发 射 器 : 一 个 PUB/SUB 的 例子 


前 面 的 例子 用 了 一 个 带 事 件 发 射 器 的 Node 内 置 API。 然 而 你 可 以 用 Node 内 置 的 事件 模块 创 
建 自 己 的 事件 发 射 器 。 

下 面 的 代码 定义 了 一 个 channel 事件 发 射 器 ， 带 有 一 个 监听 器 ， 可 以 向 加 入 频道 的 人 做 出 
啊 应 。 注 意 这 里 用 on (或 者 用 比较 长 的 aaqListenet ) 方法 给 事件 发 射 句 添加 了 监听 需 : 
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const EventEmitter = require('events') .EventEmitter; 
const channel = new EventEmitter(); 
channel.on('join', () => { 

console.log('Welcome!'); 


}); 








中 加 上 一 行 ， 用 emit 郴 数 发 射 这 个 事件 : 


channel .emit ('join'); 


事件 名 称 事件 是 可 以 具有 任意 字符 串 值 的 键 : data、join 或 菜 些 长 的 让 人 发 疲 
的 事件 名 都 行 。 只 有 一 个 事件 是 特殊 的 ， 那 就 是 error， 我 们 马上 就 会 看 到 它 。 




















然而 这 个 join 回调 永远 都 不 会 被 调用 ， 因 为 你 还 没 发 射 任何 事件 。 所 以 还 要 在 上 面 的 代码 


接 下 来 看 看 如 何 用 EventEmitter 实现 自己 的 发 布 /预订 逻辑 ， 做 一 个 通信 通道 。 如 果 运 行 





代码 清单 2-11 中 的 脚本 ， 你 就 会 得 到 一 个 简单 的 聊天 服务 器 。 聊 天 服务 咒 的 频道 被 做 成 了 习 





有 件 


发 射 器 ， 能 对 客户 端 发 出 的 join 事件 做 出 响应 。 当 有 客户 端 加 入 聊天 频道 时 ，join 监听 咒 罗 
辑 会 将 一 个 针对 该 客户 端的 监听 需 附 加 到 频道 上 ， 用 来 处 理会 将 所 有 广播 消息 写 人 该 客户 端 








socket 的 broadcast 事件 。 事 件 类 型 的 名 称 ， 比 如 join 和 broadqcast ， 完 全 是 随意 取 的 。 你 
也 可 以 按 自己 的 喜好 给 它们 换个 名 字 。 
代码 清单 2-11 用 事件 发 射 器 实现 的 简单 的 发 布 /预订 系统 
Const events = require('events'); 
const net = require('net'); 
const channel = new events.EventEmitter(); 
channel.clients = {}; 添加 join 事件 的 监听 器 ， 保 
channel.subscriptions = {}; 存 用 户 的 client 对 象 ， 以 便 
channel.on('join', function(id, client) { 程序 可 以 将 数据 发 送 给 用 户 
this.clients[id] = client; 
this.subscriptions[id] = (senderId, message) => { 
if (Ld =."Senderid) { < 一 为 ;> 出 广 一 
this.clients[id] .write(message); 人 广播 
} 
ye 
this.on('broadcast', this.subscriptions[id]); 了 一 添加 一 个 专门 针对 当前 
) ) ; 证 名 
const server = net.createsServer (client =>, { 人 事件 
const id = ‘${client.remoteAddress}:${client.remotepPort}.; 9p 
channel.emit ('join', id, client); < 十 一 一 当 有 用 户 连 到 服务 器 上 时 发 出 
client.on('data', data => { 一 个 join 事件 ， 指 明 用 户 ID 
data = data.toString(); S 
channel.emit ('broadcast', id, data); Oo 和 client 对 象 
区 了 当 有 用 户 发 送 数据 时 ， 发 出 
区 一 个 频道 broadcast 事件 ， 
server.listen(8888); 指明 用 户 ID 和 消息 


把 聊天 服务 器 跑 起 来 后 , 打开 一 个 新 的 命令 行 窗口 ,并 在 其 中 输入 下 面 的 命令 进入 聊天 程序 : 








telnet 127.0.0.1 8888 
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如 果 你 打开 几 个 命令 行 窗口 , 在 其 中 任何 一 个 窗口 中 输入 的 内 容 都 将 会 被 发 送 到 其 他 所 有 窗 
口中 。 

这 个 聊天 服务 器 还 有 一 个 问题 ,在 用 户 关 闭 连 接 离开 聊天 室 后 ,原来 那个 监听 器 还 在 , 仍 会 
尝试 向 已 经 断 开 的 连接 写 数据 。 这 样 自然 就 会 出 错 。 为 了 解决 这 个 问题 , 还 要 按照 下 面 的 代码 清 
单 把 监听 器 添加 到 频道 事件 发 射 器 上 ， 并 且 向 服务 器 的 close 事件 监听 器 中 添加 发 射频 道 的 
leave 事件 的 处 理 逻 辑 。leave 事件 本 质 上 就 是 要 移 除 原来 给 客户 端 添 加 的 proadcast 监听 髓 。 


代码 清单 -12 创建 一 个 在 用 户 断 开 连 接 时 能 “打扫 战场 ”的 监听 器 



































channel.on('leave', function(id) { SS 创建 leave 事件 
channel .removeListener!( 的 监听 器 


'broadcast', this.subscriptions[id] 
7 
channel.emit ('broadcast', id, ‘${id} has left the chatroom.Nn ); < 
}); et 
GONnst ‘Seryer = net .createServer (client = { 移 除 指定 客户 端的 
broadcast 监听 器 
client.on('close', () => { 
channel .emit ('leave', id); < 一 在 用 户 断 开 连接 时 


)) 5 发 出 leave 事件 


server.listen(8888); 


如 果 出 于 某 种 原因 你 想 停 止 提 供 聊 天 服务 ， 但 又 不 想 关 掉 服 务 器 ， 可 以 用 removeA1l1l- 
Listeners 事件 发 射 器 方法 去 掉 给 定 类 型 的 全 部 监听 器 。 下 面 是 在 我 们 的 聊天 服务 器 上 使 用 这 
一 方法 的 示例 : 

channel.on('shutdown', () => { 

channel.emit ('broadcast', '', 'The server has shut down.\n'); 


channel .removeAllListeners('broadcast'); 
学 


然后 你 可 以 添加 一 个 停止 服务 的 聊天 命令 。 为 此 需要 将 daata 事件 的 监听 器 改 成 下 面 这 样 : 




















client.on('data', data => { 
data = data.toString(); 
if (data === 'shutdown\r\n') { 
channel .emit ('shutdown'); 
} 
channel.emit ('broadcast', id, data); 
a 


现在 只 要 有 人 输入 shut gown 命令 ， 所 有 参与 聊天 的 人 都 会 被 跑 出 去 。 





错误 处 理 
在 错误 处 理 上 有 个 常规 做 法 ,你 可 以 创建 发 出 error 类 型 事件 的 事件 发 射 器 ， 而 不 是 直 
接 抛 出 错误 。 这 样 就 可 以 为 这 一 事件 类 型 设置 一 个 或 多 个 监听 器 ， 从 而 定义 定制 的 事件 响应 
逻辑 。 


32 第 2 章 Node 编程 基础 





下 面 的 代码 显示 的 是 一 个 错误 监听 器 如 何 将 被 发 出 的 错误 输出 到 控制 台中 : 

const events = require('events'); 

const myEmitter = new events.EventEmitter(); 

Tn 

com lo RRO nen 

J 

I Ee er One (0 OrroOm OW Piror( oomenino LS won 

如 果 发 出 这 个 error 事件 类 型 时 没有 该 事件 类 型 的 监听 器 ， 事 件 发 射 器 会 输出 一 个 栈 跟 
踪 (到 错误 发 生 时 所 执行 过 的 程序 指令 列表 ) 并 停止 执行 。 栈 跟踪 会 用 emit 调用 的 第 二 个 参 
数 指明 错误 类 型 。 这 是 只 有 错误 类 型 事件 才能 享受 的 特殊 待遇 , 在 发 出 没有 监听 器 的 其 他 事件 
类 型 时 ， 什 么 也 不 会 发 生 。 

如 果 发 出 的 error 类 型 事件 没有 作为 第 二 个 参数 的 error 对 象 ， 栈 跟踪 会 指出 一 个 “未 
捕获 、 未 指明 的 “错误 ”事件 ”错误 ， 并 且 程 序 会 停止 执行 。 你 可 以 用 一 个 已 经 被 废除 的 方法 
处 理 这 个 错误 ， 用 下 面 的 代码 定义 一 个 全 局 处 理 器 实现 响应 逻辑 : 

1 

Console.error(err.stack),; 


process .exit (1); 


J 
除了 这 个 ， 还 有 像 domains 这 样 正在 开发 的 方案 ,但 它们 是 实验 性 质 的 。 





如 果 你 想 让 连接 上 来 的 用 户 看 到 当前 有 几 个 已 连接 的 聊天 用 户 ， 可 以 用 下 面 这 个 监听 需 方 
法 ， 它 能 根据 给 定 的 事件 类 型 返回 一 个 监听 需 数 组 : 


channel.on('join', function(id, client) { 
const welcome = . 
Welcome! 
Guests online: S${this.listeners('broadcast').length} 





四 


client .write( StfwelcomejAn ) 


为 了 增加 能 够 附加 到 事件 发 射 锅 上 的 监听 器 数量 , 不 让 Node 在 监听 需 数 量 超过 10 个 时 向 你 
发 出 警告 , 可 以 用 setMaxListeners 方法 。 以 频道 事件 发 射 器 为 例 , 可 以 用 下 面 的 代码 增加 监 
听 需 的 数量 : 


channel.setMaxListeners(50); 











2.8.4 扩展 事件 监听 器 : 文件 监视 器 


如 果 你 想 在 事件 发 射 器 的 基础 上 构建 程序 ， 可 以 创建 一 个 新 的 JavaScript 类 继承 事件 发 射 器 。 
比如 创建 一 个 watcher 类 来 处 理 放 在 某 个 目录 下 的 文件 。 然 后 可 以 用 这 个 类 创建 一 个 工具 ， 该 
工具 可 以 监视 目录 (将 放 到 里 面 的 文件 名 都 改 成 小 写 的 ， 并 将 文件 复制 到 一 个 单独 目录 中 )。 
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设置 好 Watcher 对 象 后 ,还 需要 加 两 个 新 方法 扩展 继承 自 Event Emitter 的 方法 , 代码 如 
下 所 示 。 


代码 清单 2-13 扩展 事件 发 射 器 的 功能 














const fs = require('fs'); 
const events = require('events'); 
扩展 BventEmitter， 
class Watcher extends events.EventEmitter { 添加 处 理 文件 的 方法 
constructor (watchDir, processedDir) { 
super (); 


this.watchDir = watchDir; 
this.processedDir = processedDir; 


} 


watch() { 处 理 watch 目录 
fs.readdir (this.watchDir, (err, files) => { 中 的 所 有 文件 
if (err) throw err; 
for (var index in files) { 
this.emit ('process', filesl[index]); 


I 
} 


start() { < 二 一 的 方法 
fs.watchrFrile(this.watchDir, () => { 

this.watch(); 

的 学 
} 

} 


module.exports = Watcher; 


watch 方法 循环 遍历 目录 , 处 理 其 中 的 所 有 文件 。start 方法 启动 对 目录 的 监控 。 监 控 用 到 
了 Node 的 fs.watchrile 函数 ， 所 以 当 被 监控 的 目录 中 有 事情 发 生 时 ，watch 方法 会 被 触发 ， 
循环 遍历 受 监控 的 目录 ， 并 针对 其 中 的 每 一 个 文件 发 出 process 事件 。 

定义 好 了 watcher 类 ， 可 以 用 下 面 的 代码 创建 一 个 Watcher 对 象 : 


const watcher = new Watcher (watchDir, processedDir); 


有 了 新 创建 的 watcher 对 象 ， 你 可 以 用 继承 自 事件 发 射 器 类 的 on 方法 设 定 每 个 文件 的 处 
理 逻 辑 ， 如 下 所 示 : 


ha 





watcher.on('process', (file) => { 
const watchFile = ‘${watchDir}/s$s{file}.; 
const processedFile = ‘S${processedDir}/s$s{file.toLowerCase()}.，} 


fs.rename (watchFile, processedFile, err => { 
if (err) throw err; 
村 这 
这 


现在 所 有 必要 逻辑 都 已 经 就 位 了 ， 可 以 用 下 面 这 行 代码 启动 对 目录 的 监控 : 


watcher.start (); 
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把 watchez 代码 放 到 脚本 中 ， 创 建 watch 和 done 目录 ， 你 应 该 能 用 Node 运行 这 个 脚本 ， 
把 文件 丢 到 watch 目录 中 ， 然 后 看 着 文件 出 现在 done 目录 中 ,文件 名 被 改 成 小 写 。 这 就 是 用 事 
件 发 射 器 创建 新 类 的 例子 。 

通过 学 习 如 何 使 用 回调 定义 一 次 性 异步 逮 辑 , 以 及 如 何 用 事件 发 射 咒 重复 派发 异步 巡 辑 , 你 
离 掌控 Node 程序 的 行为 又 近 了 一 步 。 然 而 你 可 能 还 想 在 单个 回调 或 事件 发 射 器 的 监听 器 中 添加 
新 的 异步 任务 。 如 果 这 些 任务 的 执行 顺序 很 重要 ,你 就 会 面 对 新 的 难题 :如何 准确 控制 一 系列 异 
步 任务 里 的 每 个 任务 。 

在 我 们 学 习 如 何 控 制 任务 的 执行 之 前 (2.10 节 )， 先 来 看 一 看 在 编写 异步 代码 时 可 能 会 碰 到 
哪些 难题 。 


2.9 异步 开发 的 难题 


在 创建 异步 程序 时 ， 你 必须 密切 关注 程序 的 执行 流程 ,并 瞪 大 有 眼睛 果 着 程序 的 状态 : 事件 轮 
询 的 条 件 、 程 序 变 量 ， 以 及 其 他 随 着 程序 逻辑 执行 而 发 生变 化 的 资源 。 

比如 说 ，Node 的 事件 轮 询 会 跟踪 还 没有 完成 的 异步 逻辑 。 只 要 有 异步 逻辑 未 完成 ，Node 进 
程 就 不 会 退出 。 一 个 持续 运行 的 Node 进程 对 Web 服务 器 之 类 的 应 用 来 说 很 有 必要 ,但 对 于 命令 
行 工 具 这 种 经 过 一 段 时 间 后 就 应 该 结束 的 应 用 却 意义 不 大 。 事件 轮 询 会 跟踪 所 有 数据 库 连 接 ， 直 
到 它们 关闭 ， 以 防止 Node 退出 。 

如 果 你 不 小 心 ， 程 序 的 变量 也 可 能 会 出 现 意 想 不 到 的 变化 。 代 码 清单 2-14 是 一 段 可 能 因为 
执行 顺序 而 导致 混乱 的 异步 代码 。 如 果 例 子 中 的 代码 能 够 同步 执行 ， 你 可 以 肯定 输出 应 该 是 
“The coloris blue"。 可 这 个 例子 是 异步 的 , 在 console.1og 执行 之 前 color 的 值 还 在 变化 ,所 
以 输出 是 “The color is green”。 


代码 清单 2-14 ”作用 域 是 如 何 导致 bug 出 现 的 
function asyncFunction(callback) { 
setTimeout (callback, 200); 
中 
let color = 'blue'; 
asyncFunction(() => { 
console.log(‘The color is S${color}.); 
sy 


COLOrF'.= "green,; 

用 JavaScript 财 包 可 以 “冻结 ”color 的 值 。 在 代码 清单 2-15 中 ,对 asyncFunction 的 调 
用 被 封装 到 了 一 个 以 color 为 参数 的 匿名 函数 里 。 这 样 你 就 可 以 马上 执行 这 个 匿名 函数 ， 把 当 
前 的 color 的 值 传 给 它 。 而 color 变 成 了 匿名 函数 的 参数 ， 也 就 是 这 个 匿名 函数 内 部 的 本 地 变 
量 ， 当 匿名 函数 外 面 的 color 值 发 生变 化 时 ， 本 地 版 的 color 不 会 受 影响 。 
代码 清单 2-15 ”用 匿名 函数 保留 全 局 变量 的 值 


function asyncFunction(callback) { 
setTimeout (callback, 200); 






















































































这 个 最 后 执行 
(200ms 之 后 ) 
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} 
let color = 'blue'; 


(aOLOE SS 1 
asyncFunction(() => { 
console.log('The color is', color); 
a 
}) (eolOr)’s 





Color = 'green'; 
在 Node 开发 中 ,你 要 用 到 很 多 JavaScript 编程 技巧 ， 这 只 是 其 中 之 一 。 
闭 包 要 了 解 闭 包 的 详细 信息 ， 请 参见 Mozilla JavaScript 文档 : https://developer. 
mozilla.org/zh-CN/docs/JavaScript/Guide/Closures。 
现在 你 知道 怎么 用 闭 包 控制 程序 的 状态 了 , 接 下 来 我 们 看 看 怎么 让 异步 逻辑 顺序 执行 , 好 让 
你 可 以 掌控 程序 的 流程 。 


2.10 “异步 逻辑 的 顺序 化 


在 异步 程序 的 执行 过 程 中 ， 有 些 任务 可 能 会 随时 发 生 ， 跟 程序 中 的 其 他 部 分 在 做 什么 没 关 
系 ， 什 么 时 候 做 这 些 任务 都 不 会 出 问题 。 但 也 有 些 任务 只 能 在 某 些 特定 的 任务 之 前 或 之 后 做 。 
让 一 组 异步 任务 顺序 执行 的 概念 被 Node 社区 称 为 流程 控制 。 这 种 控制 分 为 两 类 : 串 行 和 并 
行 ， 如 图 2-10 所 示 。 
串 行 执行 并 行 执行 
























































始 开始 












































然后 任务 2 当 所 有 任务 
i 结束 后 继续 














在 任务 3 
结束 后 继续 


图 2-10 ” 串 行 的 异步 任务 在 概念 上 跟 同步 逻辑 类 似 ， 然 而 并 行 任务 不 必 一 个 接 一 个 地 执行 
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需要 一 个 接着 一 个 执行 的 任务 叫 作 串 行 任 务 。 创 建 一 个 目录 并 往 里 放 一 个 文件 的 任务 就 是 
串 行 的 。 你 不 能 在 创建 目录 前 往 里 放 文 件 。 
不 需要 一 个 接着 一 个 执行 的 任务 叫 作 并 行 任务 。 这 些 任务 彼此 之 间 开 始 和 结束 的 时 间 并 不 重 
要 ,但 在 后 续 逻 辑 执行 之 前 它们 应 该 全 部 执行 完 。 下 载 几 个 文件 然后 把 它们 压缩 到 一 个 zip 归档 
文件 中 就 是 并 行 任务 。 这 些 文件 的 下 载 可 以 同时 进行 但 在 创建 归档 文件 之 前 应 该 全 部 下 载 完 。 
跟踪 串 行 和 并 行 的 流程 控制 要 做 编程 记 账 的 工作 。 在 实现 串 行 化 流程 控制 时 , 需要 跟踪 当前 
执行 的 任务 , 或 维护 一 个 尚未 执行 任务 的 队列 。 实 现 并 行 化 流程 控制 时 需要 跟踪 有 多 少 个 任务 要 
执行 完成 了 。 
有 一 些 可 以 帮 你 记 账 的 流程 控制 工具 ， 它 
尽管 社区 创建 了 很 多 序列 化 异步 逻辑 的 辅助 工 
玄机 ， 让 你 对 如 何 应 对 异步 编程 中 的 挑战 
下 面 几 节 将 介绍 这 些 内 容 : 
口 何 时 使 用 串 行 化 流程 控制 ; 
口 如 何 实现 冲 行 化 流程 控制 ; 
口 如 何 实现 并 行 化 流程 控制 ; 
口 如 何 使 用 第 三 方 模块 做 流程 控制 。 
接 下 来 我 们 先 从 何 时 以 及 如 何在 异步 的 世界 中 实现 串 行 化 流程 控制 开始 。 


2.11 何 时 使 用 串 行 流程 控制 


可 以 使 用 回调 让 几 个 异步 任务 按 顺 序 执行 , 但 如 果 任 务 很 多 , 必须 组 织 一 下 ,否则 过 多 的 回 
调 能 套 会 把 代码 搞 得 很 乱 。 

下 面 这 段 代码 就 是 用 回调 让 任务 顺序 执行 的 。 这 个 例子 用 setTimeout 模拟 需要 花 时 间 执 
行 的 任务 : 第 一 个 任务 用 一 秒 , 第 二 个 用 半 秒 ,最 后 一 个 用 十 分 之 一 秒 。setTimeout 只 是 一 个 
人 工 模拟 ,在 真正 的 代码 中 可 能 是 读 取 文件 、 发 起 HTTP 请 求 等 。 这 段 代码 虽然 不 长 , 但 它 算 是 
比较 乱 的 了 ， 并 且 也 没有 程序 化 添加 男 一 个 任务 的 简单 办 法 。 
































们 能 让 组 织 异 步 的 串 行 或 并 行 化 任务 变 得 很 容易 。 
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setTimeout (() => { 
console.log('I execute first.'); 
setTimeout (() => { 
console.log('I execute next.'); 
setTimeout (() => { 
console.log('I execute last.'); 
er "OO 
00)s 
}° O00 





此 外 ， 你 也 可 以 用 Async 这 样 的 流程 控制 工具 执行 这 些 任务 。Async 用 起 来 简单 直接 ， 并 且 
它 的 代码 量 很 小 ( 经 过 缩小 化 和 压缩 后 只 有 837 个 字 节 )。 下 面 这 个 命令 是 用 来 安装 Async 的 : 








npm install async 
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下 面 的 代码 用 串 行 化 流程 控制 工具 重新 编写 了 前 面 那 段 代码 。 
代码 清单 2-16 用 社区 贡献 的 工具 实现 串 行 化 控制 


const async = require('async'); 
async.series([ 
callback ss. 





给 Async 一 个 函数 数组 ， 
让 它 一 个 接 一 个 地 执行 





SetTimeout (() => { 
console.log('I execute first.'); 
callback (); 

}y> :L000 


l 
callback => { 


setTimeout (() => { 
console.log('I execute next.'); 
callback(); 

}y “oO0'0s 


} 
callback = 


setTimeout (() => { 
console.log('I execute last.'); 
callback(); 

Fs 00) 


} 























a dia 但 通常 可 读 性 和 可 维护 性 更 强 。 你 一 般 也 不 会 一 
议程 控制 ， 但 当 碰 到 想 要 躲 开 回调 说 套 的 情况 时 ， 它 就 会 是 改善 代码 可 读 性 的 好 工具 。 
过 这 个 用 特制 工具 实现 串 行 化 流程 控制 的 例子 之 后 ， 我 们 来 看 看 如 何 从 头 开始 实现 它 。 











Ce 
2.12 ”实现 串 行 化 流程 控制 


为 了 用 串 行 化 流程 控制 让 几 个 异步 任务 按 顺序 执行 ， 需 要 先 把 这 些 任 务 按 预 期 的 执行 顺序 
放 到 一 个 数组 中 。 如 图 2-11 所 示 ， 这 个 数组 将 起 到 队列 的 作用 : 完成 一 个 任务 后 按 顺 序 从 数组 
中 取出 下 一 个 。 








按 预 期 的 顺序 存在 数组 中 的 任务 

















任务 任务 任务 任务 








任务 执行 函数 ， 然 后 调 | 
派发 函数 执行 队列 中 的 下 


一 个 任务 























图 2-11 ” 串 行 化 流程 控制 的 工作 机 种 





二 
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数组 中 的 每 个 任务 都 是 一 个 函数 。 任 务 完成 后 应 该 调用 一 个 处 理 器 函数 , 告诉 它 错 误 状 态 和 
结果 。 在 这 一 实现 中 ,如 果 有 错误 ， 处 理 带 函数 会 终止 执行 ;如果 没 有 错误 ， 处 理 器 就 从 队列 中 
取出 下 一 个 任务 执行 它 。 

为 了 演示 如 何 实现 串 行 化 流程 控制 ， 我 们 准备 做 个 小 程序 ， 让 它 从 一 个 随机 选择 的 RSS 预 
订 源 中 获取 一 篇 文章 的 标题 和 URL， 并 显示 出 来 。RSS 预订 源 列表 放 在 一 个 文本 文件 中 。 这 个 
旦 序 的 输出 是 像 下 面 这 样 的 文本 : 


Of Course ML Has Monads! 
http://lambda-the-ultimate.org/node/4306 


我 们 这 个 例子 需要 从 npm 存储 库 中 下 载 两 个 辅助 模块 。 先 打开 命令 行 ， 输入 下 面 的 命令 给 
例子 创建 个 目录 ， 然 后 安装 辅助 模块 : 

mkdir listing 217 

cd listing 217 

npm init -y 

npm install --save request@2.60.0 

npm install --save htmlparser@1.7.7 


request 模块 是 个 经 过 简化 的 HTTP 客户 端 ， 你 可 以 用 它 获取 RSS 数据 。ntmlparser 模 


块 能 把 原始 的 RSS 数据 转换 成 JavaScript 数据 结构 。 
接 下 来 在 新 目录 中 创建 一 个 包含 下 列 代码 的 indexjs 文件 。 


代码 清单 2-17 ”在 一 个 简单 的 程序 中 实现 串 行 化 流程 控制 


const fs = require('fs'); 














3 





















































const request = require('request'); Sa 
const htmlparser = require('htmlparser'); 任务 1: 确保 包 全 
const configFilename = './rss_feeds.txt'; RSS 预订 源 URL 
function checkForRSSFile() { 列表 的 文件 存在 
fs.exists(configFilename, (exists) => { 
if (!exists) 
return next (new Error( Missing RSS file: S${configFilename} )); 二 一 
next (null, configFilename); a 
}); 只 要 有 错误 
} 就 尽早 返回 
function readRSSFile(configFilename) { < 一 一 任务 2: 读 取 并 解析 包含 


fs.readFile(configFilename, (err, feedList) => { 
if (err) return next (err); 


LS Eee 将 预订 源 URL 列表 转换 成 字符 串 ， 


预订 源 URL 的 文件 


.上 toString () 己 公 耳目 -个头 绢 
.replace(/^\st+|\s+$/g, '') 然后 分 隔 成 一 个 数组 
.Split('\n'); 
const random = Math.floor(Math.random() * feedList.length); < 一 
本 11, feedList Q ? i 
2 (nu eedList [random]) 从 预订 源 URL 数组 中 随 
) 机 选择 一 个 预订 源 URL 
function downloadRSSFeed (feedUr1l) { 所 一 一 
request ({ uri: feedqUrl }, (err, res, body) => { 任务 3: 向 选 定 的 预订 源 发 
if (err) return next (err); 送 HTTP 请 求 以 获取 数据 


if (res.statusCode !== 200) 
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return next (new Error('Abnormal response status code')); 
next (null, body); 
a 
} 


function parseRSSFeed(rss) { = 任务 4: 将 预订 源 数据 解 
const handler = new htmlparser.RssHandqletr (); 析 到 一 个 条 目 数组 中 


Const parser = new htmlparser.Parser (handler); 
parser.parseComplete(rss); 
if (!handler.dom.items.length) 

return next (new Error('No RSS items found')); 
const item = handler.dom.items.shift(); 








So 0 Poms td) ; 所 一 一 如 果 有 数据 ， 显 示 第 一 个 预 
console.log(item.1link); 订 源 条 目的 标题 和 URL 
const tasks = [ 

Se 3 把 所 有 要 做 的 任务 按 执行 

a ee 顺序 添加 到 一 个 数组 中 

downloadRSSFeed, 

parseRSSFeed fe 
Te 负责 执行 任务 
function next (err, result) { < | 的 next 函数 

if (err) throw err; 

， 二 

consk currentTask = tasks.shift(); 4 | 从 任务 数组 中 则 抛 出 异 

if (currentTask) { | 取出 下 个 任务 

currentTask (result); 
执行 当前 } 
任务 | } 开始 任务 的 
sb < | 串 行 化 执行 











在 试用 这 个 程序 之 前 ， 先 在 程序 脚本 所 在 的 目录 下 创建 一 个 rss_feeds.txt 文件 。 如 果 你 自己 
没有 预订 源 ， 可 以 试 一 下 Node 博客 ， 地 址 是 人 nodejs.org/feed/。 把 预订 源 URL 放 到 这 
个 文本 文件 中 , 每 行 一 条 。 文 件 创建 好 后 , 打开 命令 行 窗 口 输入 下 面 的 命令 进入 程序 所 在 的 目录 
并 执行 脚本 : 


cd 1isting 217 
node index.js 


如 本 例 中 的 实现 所 示 , 串 行 化 流程 控制 本 质 上 是 在 需要 时 让 回调 进 场 ， 而 不 是 简单 地 把 它们 
诅 套 起 来 。 
你 已 经 知道 如 何 实现 串 行 化 流程 控制 了 ， 我 们 接 下 来 去 看 看 如 何 让 异步 任务 并 行 执行 。 


2.13 ”实现 并 行 化 流程 控制 


为 了 让 异步 任务 并 行 执行 , 仍然 是 要 把 任务 放 到 数组 中 , 但 任务 的 存放 顺序 无 关 紧要 。 每 个 
任务 都 应 该 调用 处 理 器 函数 增加 已 完成 任务 的 计数 值 。 当 所 有 任务 都 完成 后 ,处 理 器 函数 应 该 执 
行 后续 的 逻辑 。 

我 们 会 做 一 个 简单 的 程序 作为 并 行 化 流程 控制 的 例子 , 它 会 读 取 几 个 文本 文件 的 内 容 , 并 输 
出 单词 在 整个 文件 中 出 现 的 次 数 。 我 们 会 用 异步 的 readFile 函数 读 取 文 本 文件 的 内 容 , 所 以 几 
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个 文件 的 读 取 可 以 并 行 执行 。 这 个 程序 的 工作 方式 如 图 2-12 所 示 。 











得 到 目录 中 













ee 每 个 文件 的 读 取 及 
后 续 的 单词 计数 都 
用 异步 逻辑 处 理 是 并 行 完成 的 





其 中 的 每 个 文件 












读 取 文 件 











读 取 文 件 













单词 计数 | | 单词 计数 




















| 单词 计数 | 单词 计数 ] 





单词 计数 ] 

















所 有 文件 都 读 取 出 来 并 
完成 单词 的 计数 了 吗 ? 








显示 单词 的 计数 值 
































图 2-12 用 并 行 化 流程 控制 实现 对 几 个 文件 中 单词 频 度 的 计数 
这 个 程序 的 输出 看 起 来 应 该 像 下 面 这 样 ( 尽管 实际 上 可 能 要 长 很 多 ): 


would: 2 
wrench: 3 
writeable: 1 
you: 24 


打开 命令 行 窗口 , 输入 下 面 的 命令 创建 两 个 目录 : 一 个 是 给 我 们 这 个 例子 用 的 , 男 一 个 是 用 
来 存放 要 分 析 的 文本 文件 的 。 
mkdir listing _ 218 


cd listing 218 
mkdir text 


接 下 来 在 word_count 目录 下 创建 包含 下 面 代码 清单 中 代码 的 word_count.js 文件 。 
代码 清单 2-18 在 一 个 简单 的 程序 中 实现 并 行 化 流程 控制 


const fs = require('fs'); 
const tasks = []; 

const wordCounts = {}; 
const filesDir = './text'; 
let completedTasks = 0; 





















































function checkIfComplete() { 当 所 有 任务 全 部 完成 后 , 列 出 
Rb7C 器 ,， 


completedTasks++; 等 从 的 :; 司 下 
if (completedTasks === tasks.length) { 文件 中 用 到 的 每 单词 以 及 
1 用 了 多 少 次 


for (let index in wordCounts) { 
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console.log( ‘$s{index}: S${wordCounts[index]}.); 
} 
} 
} 


function addWordCount (word) { 
wordCounts[word] = (wordCounts[word]) ? wordCounts[lword] + 1 : 1; 


} 


function countWordsInText (text) { 
const words = text 








.toString() 
.toLowerCase() 
.Split (/\W+/) 
.Sort (); 
words 对 文本 中 出 现 的 
.filter (word => word) 单词 计数 
.forEach (word => addWordCount (word)); <— 
} 
得 出 text 目录 
fs:readdir(filesDir;, (err; :files) 三 > 中 的 文件 列表 
if (err) throw err; 
files.forEach(file => { 
人 EN 4 定义 处 理 每 个 文件 的 任务 。 
机 1 ve (err, text) => { De 
RA 步 读 取 文 件 的 函数 并 对 文件 
countWordsInText (text); 中 使 用 的 单词 计数 
checkIfComplete(); 
小) 
入 把 所 有 任务 都 添加 到 
}) (“S${filesDir}/${file}.); 函数 调用 数组 中 
tasks.push(task); < 一 ek 
} 开始 并 行 执行 
tasks.forEach (task => task()); 了 | 所 有 任务 


上 
在 试用 这 个 程序 之 前 ， 先 在 前 面 创建 的 text 目录 中 创建 一 些 文本 文件 。 在 创建 了 这 些 文件 之 
后 ， 打 开 一 个 命令 行 窗口 ， 输 入 下 面 的 命令 进入 程序 所 在 目录 并 执行 程序 脚本 : 








cd word_count 
node word_count.js 


现在 你 已 经 知道 串 行 和 并 行 化 流程 控制 的 底层 机 制 了 , 接 下 来 我 们 要 看 看 如 何 用 社区 贡献 的 
工具 在 程序 中 轻松 实现 流程 控制 ， 而 不 必 自 己 亲自 实现 。 


2.14 ”利用 社区 里 的 工具 


社区 中 的 很 多 附加 模块 都 提供 了 方便 好 用 的 流程 控制 工具 。 其 中 比较 流行 的 有 Async、Step 
和 Seq 这 三 个 。 尽 管 这 些 都 很 值得 一 看 ， 但 下 面 这 个 例子 用 的 还 是 Async。 
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社区 中 有 流程 控制 能 力 的 附加 模块 要 了 解 更 多 与 社区 中 有 流程 控制 能 力 的 附加 模 
块 相关 的 内 容 ， 请 阅读 Werner Schuster 和 Dio Synodinos 在 InfoQ 上 发 表 的 文章 “虚拟 
座谈 : 如 何 从 JavaScript 异步 编程 中 活 下 来 ”。 


下 面 这 个 例子 是 用 Async 实现 任务 序列 化 的 一 段 脚本 , 它 同 时 用 并 行 化 流程 控制 下 载 两 个 文 
件 ， 然 后 把 它们 归档 。 


此 例 在 微软 的 Windows 中 无 法 使 用 因为 Windows 中 没有 tar 和 curl 这 两 个 命 
令 ， 所 以 下 面 这 个 例子 在 Windows 中 无 法 使 用 。 


在 这 个 例子 中 ， 我 们 用 串 行 化 控制 来 保证 在 文件 下 载 完成 之 前 不 会 做 归档 处 到 
代码 清单 2-19 在 简单 的 程序 中 使 用 社区 附加 模块 中 的 流程 控制 工具 


const async = require('async'); 

const exec = require('child process') .exec; 

function downloadNodeVersion(version, destination, callback) { < 
const url = ‘http://nodejs.org/dist/v$s{version}/node-v$s{version}.tar.gz，} 
const filepath = ‘$s{destination}/${version}.tgz，} 
exec (“curl S${url} > ${filepath}.’, callback); 下 载 指定 版 本 

} 的 Node 源码 


async.series([ ee 
callback => { 0 


async.parallel([ 
并 行 callback => { 
下 载 console.log('Downloading Node v4.4.7...'); 


downloadNodeVersion('4.4.7', '/tmp', callback); 



































HH 








5 
callback. SS 
console.log('Downloading Node v6.3.0...'); 
downloadNodeVersion('6.3.0', '/tmp', callback); 
} 
], callback); 
5 
callback => { 


console.log('Creating archive of downloaded files...'); 创建 归 
exec( 档 文 件 
'tar cvf node distros.tar /tmp/4.4.7.tgz /tmp/6.3.0.tgz', 
err => { 


if (err) throw err; 
console.log('All done!'); 
callback(); 
} 
> 
} 
] 3 


这 段 脚 本 定义 了 一 个 可 以 下 载 指定 版 本 Node 源码 的 辅助 函数 。 然 后 串 行 执行 了 两 个 任务 : 并 
行 下 载 两 个 版 本 的 Node， 然 后 将 下 载 好 的 版 本 归档 到 一 个 新 文件 中 。 














2.15 总结 


口 Node 模块 可 以 被 组 织 成 可 重用 的 模块 。 

口 require 因数 是 用 来 加 载 模块 的 。 

口 moqule.exports 和 exports 对 象 是 用 来 分 享 模块 内 的 函数 和 变量 的 。 
口 package.json 文件 是 用 来 指明 依赖 项 的 ， 还 要 指明 将 哪个 文件 作为 主 文件 。 
口 异步 逻辑 可 以 用 肉 套 回调 、 事 件 发 射 器 和 流程 控制 工具 来 控制 。 





























第 3 章 
Node Web 程序 是 什么 








本 章 内 容 

口 创建 一 个 新 的 Web 程序 
口 搭建 RESTful 服务 

口 持久 化 数据 

口 使 用 模板 

















本 章 介 绍 的 内 容 全 部 都 是 关于 Node Web 程序 的 。 看 完 之 后 ， 你 不 仅 会 知道 Node Web 程序 
看 起 来 是 什么 样 的 , 还 能 学 会 如 何 开 始 搭建 这 样 的 程序 。Web 开发 人 员 在 开发 程序 时 要 做 的 每 一 
件 事 你 都 会 看 到 。 

我 们 准备 带 你 一 起 搭建 一 个 名 为 later 的 Web 程序 ， 其 创意 来 自 Instapaper 和 Pocket 这 样 的 
“回头 再 看 ”网 站 。 涉 及 的 工作 包括 开始 一 个 新 的 Node 项 目 、 管理 依赖 项 、 创 建 RESTful API、 
把 数据 保存 到 数据 库 中 ,以 及 用 模板 做 一 个 用 户 界面 。 虽然 看 起 来 有 很 多 内 容 , 但 不 用 担心 , 我 
们 还 会 在 后 续 章 节 中 详细 讲解 这 里 提 到 的 每 一 项 工作 。 

图 3-1 是 最 终结 果 的 样子 。 
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Bletchley Park tweet saves Alan Turing 
computing papers 


usiness ”Poltics Tech Science Health Education ”More ~ 


England Regions Beds, Herts & Bucks 


则 Bletchley Park tweet saves Alan Turing 
Sir John Dermot Turing looks at Stephen Kettle's sculpture of his uncle Alan computing papers 


Turing at the exhibition 
© 12 March 2012 | Bods, Horts & Bucks 
There Is something quite fitting that a single tweet sparked off a campaign to save tne 
Work of a man Who helped to develop the world' sfirst modern computer. 
There is something quite fitting 
that a single tweet sparked off a 
campaign to save the work of a 
man who helped to develop the 
‘took his own Iife in 1954 at the age of 41, helped to create the Bombe world's first modern computer. 
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图 3-1 一 个 “回头 再 看 ”Web 程序 


3.1 了 解 Node Web 程序 的 结构 45 











左 侧 的 “回头 再 看 ”页 面 剥 离 了 目标 网 站 的 无 关 元 素 ， 只 留 下 了 标题 和 内 容 主体 。 更 重要 的 
是 这 篇 文章 被 永久 存放 到 了 数据 库 中 , 也 就 是 说 即便 将 来 连 原始 文章 都 找 不 到 了 , 你 还 是 可 以 读 
到 它 。 

在 开始 搭建 Web 程序 之 前 , 应 该 先 创建 一 个 新 项 目 。 接 下 来 我 们 会 介绍 如 何 从 头 开始 创建 
一 个 Node 项 日 o 
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典型 的 Node Web 程序 是 由 下 面 几 部 分 组 成 的 : 

口 package.json 一 个 包含 依赖 项 列表 和 运行 这 个 程序 的 命令 的 文件 ; 

口 public/ 一 一 静态 资源 文件 夹 ，CSS 和 客户 端 JavaScript 都 放 在 这 里 ; 

口 node_ modules/ 一 一 项 目的 依赖 项 都 会 装 到 这 里 ; 

口 放 程序 代码 的 一 个 或 多 个 JavaScript 文 件 。 

程序 代码 一 般 又 会 分 成 下 面 几 块 : 

口 appJjs 或 index.js 设置 程序 的 代码 ; 

口 models/ 一 一 数据 库 模型 ; 

口 views/ 一 一 用 来 泻 染 页 面 的 模板 ; 

口 controllers/ 或 routes/ 一 HTTP 请 求 处 理 器 ; 

口 middleware/ 中 间 件 组 件 。 
如 何 组 织 程序 是 你 的 自由 : 大 部 分 Web 框架 都 很 灵活 ， 并 且 需 要 配置 。 但 大 多 数 程序 都 是 

按照 上 面 给 出 的 结构 组 织 的 。 
最 好 的 学 习 方 法 就 是 亲自 动手 实践 , 所 以 让 我 们 看 看 老练 的 Node 程序 员 是 如 何 创 建 Web 程 

序 框架 的 。 


3.1.1 开始 一 个 新 的 Web 程序 


要 创建 一 个 新 的 Web 程序 ， 需 要 先 做 一 个 新 的 Node 项目。 如 果 你 忘记 怎么 做 了 ， 可 以 回去 
温习 一 下 第 2 章 。 其 实 很 简单 ， 只 需要 创建 一 个 目录 ， 然 后 运行 npm init， 记 得 加 上 接受 所 有 
默认 值 的 参数 : 

mkdir later 


cd later 
npm init -fy 


有 了 新 项 目 ， 然 后 呢 ? 大 多 数 人 都 会 用 npm 上 的 模块 来 降低 开发 难度 。Node 自 带 了 一 个 http 
模块 ， 它 有 个 服务 器 。 但 使 用 http 模块 依然 需要 做 很 多 套路 化 的 开发 工作 , 所 以 我 们 一 般 会 选择 
使 用 更 便捷 的 Express。 下 面 来 看 一 下 怎么 安装 。 

1. 添加 依赖 项 

要 添加 项 目 依赖 项 ， 可 以 用 npm install。 下 面 这 个 就 是 安装 Express 的 命令 : 
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npm install --save express 

如 果 现 在 看 一 下 package.json， 你 应 该 会 看 到 Express 已 经 给 加 上 去 了 。 也 就 是 说 package.json 
中 应 该 会 有 类 似 于 下 面 这 样 的 代码 : 

"dependencies": { 


"express": "^4.14.0" 
} 


Express 模块 也 应 该 装 在 了 这 个 项 目的 node modules/ 文件 夹 下 。 如 果 想 印 载 Express， 可 以 
运行 npm rm express --save。 这 个 命令 会 把 它 从 node_modules/ 中 删除 , 还 会 更 新 package.json 





























一 个 简单 的 服务 
a 以 Node 自 带 带 的 http 模块 为 基础 ， 致 力 于 在 HTTP 请 求 和 响应 上 来 建 模 Web 程序 。 
为 了 做 出 一 个 最 基本 的 程序 ， 我 们 需要 用 express () 创 建 一 个 程序 实例 ， 添 加 路 由 处 理 器 ， 然 
后 将 这 个 程序 实例 绑 定 到 一 个 TCP 端口 上 。 下 面 是 最 基本 的 程序 所 需 的 全 部 代码 : 


const express = require('express'); 
const app = express(); 























const port = process.env.PORT || 3000: 


app.get('/', (req, res) => { 
res.send('Hello World'); 
3 


app.listen(port, () => { 
console.log( ‘Express web app available at localhost: S${port}.); 


中 小 

看 起 来 并 不 像 你 想 的 那么 复杂 ! 将 这 段 代 码 放 到 index.js 文件 中 ,用 node inqex.js 运行 
它 。 然 后 访问 http://localhost:3000 看 一 下 结果 。 每 个 程序 的 运行 命令 可 能 会 不 太一 样 ， 记 起 来 很 
麻烦 ， 所 以 大 部 分 人 会 用 npm 脚本 解决 这 个 问题 。 

3. npm 脚本 

启动 服务 器 的 命令 (node index.js) 可 以 保存 为 npm 脚本 ， 打 开 package.json 文件 ， 在 
scripts 里 添加 一 个 start 属性 : 











Wen no 
"start": "node index.js", 
"test": "echo \"Error: no test specified\" && exit 1" 


} 

现在 只 要 运行 npm start 就 可 以 启动 程序 了 。 如 果 你 看 到 有 错误 提示 说 端口 3000 已 经 被 占 
用 ,那么 可 以 运行 PoRT=3001 npm start 使 用 另外 一 个 端口 。npm 脚本 可 以 做 很 多 事情 : 构 
建 客 户 端 包 、 执 行 测试 、 生 成 文档 等 。 它 基本 上 就 是 一 个 微型 脚本 调用 工具 ， 所 以 只 要 你 喜欢 ， 
放 什 么 都 行 。 
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3.1.2 跟 其 他 平台 比 一 比 
如 果 用 PHP 实现 上 面 那 个 程序 ， 代 码 如 下 : 


<?php echo '<p>Hello World</p>'; ?> 

只 有 一 行 ， 并 且 一 看 就 明白 ， 那 么 这 个 更 加 复杂 的 Node 示例 有 什么 优点 呢 ? 二 者 是 编程 范 
式 上 的 区 别 : 用 PHP, 程序 是 页 面 ; 用 Node, 程序 是 服务 器 。 这 个 Node 示例 可 以 完全 控制 请 求 
和 响应 ， 不 用 配置 服务 器 就 可 以 做 所 有 事情 。 如 果 要 用 HTTP 压缩 或 URL 转发 ， 可 以 将 这 些 功 
能 作为 程序 的 逻辑 来 实现 。 不 需要 把 HTTP 和 程序 逻辑 分 开 ， 它 们 是 程序 的 一 部 分 。 

与 其 把 HTTP 服务 器 的 配置 分 离 出 去 ,不 如 把 它们 放 在 一 起 ,也 就 是 放 在 相同 的 目录 下 。 
此 Node 程序 更 容易 部 署 和 管理 。 

npm 也 让 Node 程序 的 部 署 变 得 更 容易 了 。 因 为 各 自 的 依赖 项 是 装 在 项 目 里 的 ， 所 以 同一 系 
统 上 的 不 同 项 目 间 不 会 发 生 冲突 。 







































































3.1.3 然后 呢 


现在 你 已 经 掌握 了 用 npm init 创建 项 目 和 用 npm install --save 安装 依赖 项 的 技巧 ， 
可 以 快速 创建 新 的 项 目 了 。 太 棒 了 ! 你 能 把 自己 的 新 想法 变 成 新 项 目 了 。 比 如 说 ， 你 对 一 个 热门 
的 Web 框架 感 兴趣 ， 想 要 尝试 一 下 ， 就 可 以 创建 一 个 新 目录 ， 运 行 npm init， 然 后 用 npm 安 
装 那 个 框架 模块 。 

搞定 了 这 些 ， 就 可 以 开始 写 代 码 了 。 到 了 这 一 步 ， 你 可 以 在 项 目 里 添加 JavaScript 文件 ， 用 
require 加 载 之 前 通过 npm install --save 安装 的 模块 。 现 在 我 们 的 重点 是 大 部 分 Web 程 
序 员 接 下 来 要 做 的 事情 ， 即 添加 一 些 RESTful 路 由 。 这 能 帮 有 我 们 确定 程序 的 API， 以 及 确定 需要 
哪些 数据 库 模 型 。 
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你 的 程序 需要 一 个 RESTful Web 服务 ， 以 便 像 Instapaper 和 Pocket 那样 创建 和 保存 文件 。 
为 了 将 杂乱 的 Web 页 面 变 成 整洁 的 文章 ， 这 个 服务 需要 用 到 一 个 模块 ， 类 似 最 早 的 Readability 
服务 。 

设计 RESTful 服务 时 ， 要 想 好 需要 哪些 操作 ， 并 将 它们 映射 到 Express 里 的 路 由 上 。 就 此 例 
而 言 , 需要 实现 保存 文章 、 获 取 文 章 、 获 取 包 含 所 有 文章 的 列表 和 删除 不 再 需要 的 文章 这 几 个 功 
能 。 分 别 对 应 下 面 这 些 路 由 : 

口 POST /articles 创建 新 文章 ; 

D GET /articles/:id 获取 指定 文章 ; 

获取 所 有 文章 ; 

口 DELETE /articles/:id 一 一 诈 除 指定 文章 。 

在 考虑 数据 库 和 Web 界面 等 问题 之 前 , 我 们 先 重点 解决 如 何 用 Express 创建 RESTful 资源 的 

















D GET /articles 




















48 第 3 章 Node Web 程序 是 什么 











问题 。 你 可 以 用 cURL 向 示例 程序 发 起 请 求 ， 然 后 再 逐步 实现 数据 存储 等 更 加 复杂 的 操作 ， 让 它 
越 来 越 像 一 个 真正 的 Web 程序 。 
下 面 这 个 简单 的 Express 程序 实现 了 这 些 路 由 ,不 过 现在 是 用 JavaScript 数组 来 存储 文章 的 。 


代码 清单 3-1 RESTful 路 由 示例 




















const express = require('express'); 

const app = express(); 

const articles = [{ title: 'Example' }]; 
app.set('port', process.env.PORT || 3000); 


9 获取 所 有 文章 
app.get('/articles', (req, res, next) => { 


res.sendl(articles); 
二 


9 创建 一 篇 文章 
app.post('/articles', (req, res, next) => { 

res.send('OK'); 
3 

9 获取 指定 文章 

app.get('/articles/:id', (req, res, next) => { 

const id = req.params.id; 

console.log('Fetching:', id); 


res.send(articles[id]); 
二 


app.delete('/articles/:id', (req, res, next) => { 
const id = req.params.id; @@ 区 除 指定 文章 


console.log('Deleting:', id); 

delete articles[id]; 

res.send({ message: 'Deleted' }); 
的 过 


app.listen(app.get('port'), () => { 
console.log('App started on port', app.get ('port')); 
}); 


module.exports = app; 

将 这 段 代 码 保存 为 index.js， 然 后 就 可 以 用 node index.js 运行 了 。 请 按 下 面 的 步骤 使 用 
这 个 例子 : 

mkdir listing3_1 

cd listing3_1 


npm init -fy 
run npm install --save express@4.12.4 


第 2 章 详细 介绍 了 如 何 创建 新 的 Node 项 目 。 
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示例 代码 的 运行 及 修改 
在 运行 这 些 示例 代码 时 ， 每 次 修改 之 后 一 定 要 记得 重启 服务 器 。 重 启 方法 是 按 住 Ctrl-C 
结束 Node 进程 ， 然 后 再 用 node index.js 启动 它 。 
例子 中 的 代码 全 在 代码 清单 中 ， 所 以 你 应 该 可 以 按 顺序 把 它们 组 合成 一 个 可 以 运行 的 程 
序 。 如 果 无 法 运行 ， 可 以 从 图 灵 社 区 下 载 本 书 中 的 代码 。 


代码 清单 3-1 中 有 一 个 示例 数据 数组 ， 用 Express 的 res .sena 方法 发 送 JSON 响应 时 返回 
的 所 有 文章 都 在 这 个 数组 @。Express 能 自动 将 数组 转换 成 JSON 响应 , 非常 适合 制作 REST API。 

这 个 例子 也 可 以 用 同样 的 办 法 发 送 一 篇 文章 全 。 甚至 可 以 用 标准 的 JavaScript delete 关键 字 
和 URL 中 指定 的 数字 ID 删除 一 篇 文章 @。 可 以 在 路 由 字符 串 中 指定 参数 , 比如 /articles/:ig,， 
然后 用 req.params .ia 获取 URL 中 对 应 位 置 的 值 。 

代码 清单 3-1 还 没 实现 创建 文章 @ 的 功能 ， 因 为 那 需要 一 个 请 求 体 解 析 器 ; 我 们 下 一 他 再 讲 
这 个 。 现 在 先 看 看 如 何 用 cURL 访问 这 个 例子 。 

用 node indqex.js 把 这 个 例子 跑 起 来 之 后 ， 可 以 用 浏览 器 或 cURL 向 它 发 送 请 求 。 要 获取 
一 篇 文章 ， 可 以 运行 下 面 的 命令 : 

curl http://localhost:3000/articles/0 

要 获取 所 有 文章 ， 可 以 请 求 /articles: 

curl http://localhost:3000/articles 

甚至 可 以 删除 一 篇 文章 : 

curl -X DELETE http://localhost:3000/articles/0 

但 为 什么 说 不 能 创建 文章 呢 ? 主要 是 因为 处 理 POST 请 求 需要 消息 体 解析 。 之 前 Express 
有 个 内 置 的 消息 体 解 析 器 ， 但 因为 实现 方法 太 多 ， 所 以 开发 人 员 把 它 分 离 出 来 做 成 了 一 个 独立 
的 模块 。 

消息 体 解析 器 知道 如 何 接 收 MIME-encoded ( 多 用 途 互 联网 邮件 扩展 ) POST 请 求 消息 的 主 
体 部 分 ， 并 将 其 转换 成 代码 可 用 的 数据 。 一 般 来 说 ， 它 给 出 的 是 易于 处 理 的 JSON 数据 。 只 要 网 
站 上 有 涉及 提交 表单 的 请 求 ， 服 务 器 端 就 肯定 会 有 一 个 消息 体 解 析 器 来 参与 这 个 请 求 的 处 理 。 

可 以 运行 下 面 的 命令 添加 受到 官方 支持 的 消息 体 解析 器 : 

npm install --save body-parser 

接 下 来 像 下 面 的 代码 清单 中 那样 ,在 靠近 文件 顶部 的 地 方 加 载 这 个 消息 体 解析 器 。 如 果 你 一 
直 在 跟着 我 们 的 进度 ， 可 以 将 它 保存 到 代码 清单 3-1 所 在 的 目录 (listing3_1 ) 中 , 但 在 本 书 源码 
中 我 们 新 给 它 建 了 个 目录 (ch03-what-is-a-node-web-app/listing3 2 )。 
代码 清单 3-2 ”添加 消息 体 解析 器 


const express = require('express'); 
const app = express(); 
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const articles = [{ title: 'Example' }]; 
const bodyParser = require('body-parser'); 


app.set('port', process.env.PORT || 3000); 
支持 编码 为 JSON 
app.use (bodyParser.json()); 的 请 求 消息 体 
app.use (bodyParser.urlencoded({ extended: true })); 支持 编码 为 表单 
. 的 请 求 消息 体 
app.post('/articles', (req, res, next) => { 


const article = { title: req.body.title }; 
articles.push(article); 
res.send(article); 

中 


这 样 一 来 程序 新 增 了 两 个 很 实用 的 功能 : JSON 消息 体 解 析 @Q@ 和 表单 编码 消息 体 解析 @。 还 
新 增 了 一 个 非常 简单 的 文章 创建 功能 : 如 果 发 送 一 个 带 有 title 域 的 POST 请 求 ， 文 章 数组 中 
会 增加 一 篇 新 文章 。 下 面 是 发 出 这 样 请 求 的 cURL 命令 : 

curl --data "title=Example 2" http://localhost:3000/articles 


茶 喜 你 ， 这 已 经 跟 真 正 的 Web 程序 差不多 了 ! 你 只 需要 青 完成 两 个 任务 就 大 功 告 成 了 。 甸 
一 个 任务 是 将 数据 永久 保存 在 数据 库 里 ， 第 二 个 任务 是 为 网 上 找到 的 文章 生成 一 个 可 读 版 本 。 


3.3 添加 数据 库 


就 往 Node 程序 中 添加 数据 库 而 言 ， 并 没有 一 定之 规 ， 但 一 般 会 涉及 下 面 几 个 步 又 。 
(1) 决定 想 要 用 的 数据 库 系 统 。 
(2) 在 npm 上 看 看 那些 实现 了 数据 库 驱 动 或 对 象 - 关 系 映射 (ORM ) 的 热门 模块 。 
(3) 用 npm --save 将 模块 添加 到 项 目 中 。 
(4) 创建 模型 ， 封 装 数据 库 访 问 API。 
(5) 把 这 些 模 型 添加 到 Express 路 由 中 。 
在 添加 数据 库 之 前 ， 我 们 还 是 先 在 Express 中 添加 第 (5) 步 的 路 由 处 理 代码 。 程 序 中 的 HTTP 
路 由 处 理 器 会 向 模型 发 出 一 个 简单 的 调用 。 这 里 有 个 例子 : 
app.get('/articles', (req, res, err) => { 
Article.all (err, articles) => { 
if (err) return next (err); 
res.sendl(articles); 


3 
学 


这 个 HTTP 路 由 是 用 来 获取 所 有 文章 的 ， 所 以 对 应 的 模型 方法 应 该 类 似 于 Article.all。 
这 要 取决 于 数据 库 API， 一 般 来 说 应 该 是 Article.find({}，cb) 和 Article.fetchaAll() . 
then (cb) ， 其 中 的 cb 是 回调 (callback ) 的 缩写 。 

数据 库 系 统 这 么 多 , 怎么 决定 该 选 哪个 呢 ? 这 个 例子 中 选 了 SQLite, 至 于 理由 , 且 听 我 们 慢 
晕 道 来 。 
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选 哪个 数据 库 
在 这 个 项 目 里 ， 我 们 准备 用 SQLite， 还 有 热门 的 sqlite3 模块 。SQLite 是 进程 内 数据 库 ， 
所 以 很 方便 : 你 不 需要 在 系统 上 安装 一 个 后 台 运 行 的 数据 库 。 你 添加 的 所 有 数据 都 会 写 到 一 个 
文件 里 ， 也 就 是 说 程序 停 掉 后 再 起 来 时 数据 还 在 ， 所 以 非常 适合 入 门 学 习 时 用 。 


3.3.1 制作 自己 的 模型 API 


文章 应 该 能 被 创建 、 被 获取 、 被 删除 ， 所 以 模型 类 Article 应 该 提供 下 面 这 些 方法 : 
口 Article.all (cb) 一 一 返回 所 有 文章 ; 
D Article.find(id, cb) 给 定 ID ， 找 到 对 应 的 文章 ; 














口 Article.ctreate({ title,content }, cb) 一 一 创建 一 篇 有 标题 和 内 容 的 文章 ; 
口 Article.delete(id，cb) 一 一 根据 ID 删除 文章 。 


这 些 都 可 以 用 sqlite3 模 块 实现 。 有 了 这 个 模块 ,我 们 可 以 用 ab .al1 获取 多 行 数据 ,用 db.get 
获取 一 行 数据 。 不 过 先 要 有 数据 库 连 接 。 

下 面 的 代码 清单 演示 了 如 何在 Node 中 使 用 SQLite 实现 上 述 功能 。 这 段 代码 应 该 存在 dbjs 
中 ， 跟 代码 清单 3-1 那个 文件 放 到 同一 个 文件 夹 下 。 


代码 清单 3-3 ”模型 类 Article 


const sqlite3 = require('sqlite3') .verbose() : 




















const dbName = 'later.sqlite'; 
const db = new sqlite3.Database (dbName); 连接 到 一 个 
数据 库 文件 
db.serialize(() => { 
(eke ero EN 
CREATE TABLE IF NOT EXISTS articles 
(id integer primary key, title, content TEXT) 
db.run(sql); Ne 
}); 如 果 还 没有 , 创建 
“ 一 个 “articles” 表 
class Article { 
statie -all teb), "{ 
db.all('SELECT * FROM articles', chb); 
: é 获取 所 有 文章 
static find(id, cb) { 
db.get ('SELECT * FROM articles WHERE id = ?', id, cb); 选择 一 篇 指 
} 定 的 文章 
static create(data, cb) { 
const sql = 'INSERT INTO articles(title, content) VALUES (?, ?)'; 
db.run(sql, data.title, data.content, cb); 
} 问号 表示 
参数 


static deletel(id, cb) { 
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if (!id) return cb (new Error('Please provide an id')); 
db.run('DELETE FROM articles WHERE id = ?', id, cb); 
了 
} 


module.exports = db; 
module.exports.Article = Article; 


这 个 例子 中 创建 了 一 个 名 为 Article 的 对 象 , 它 可 以 用 标准 SQL 和 sqlite3 模块 创建 、 获 取 
和 删除 数据 。 首 先 用 salite3 .Database 打开 一 个 数据 库 文件 @， 然 后 创建 表 articles@。 
这 里 用 到 了 SQL 语法 IF NOT EXISTS， 以 防 一 不 小 心 重新 运行 代码 时 市 掉 之 前 的 表 重新 创建 一 个 。 

数据 库 和 表 准 备 好 之 后 ， 这 个 程序 就 可 以 进行 查询 了 。 用 sqlite3 的 al1l 方法 可 以 获取 所 有 
文章 全 。 用 给 带 问号 的 查询 语法 提供 具体 值 的 方法 可 以 获取 指定 文章 人 @，sqlite3 会 把 ID 插入 到 
查询 语句 中 。 最 后 ， 可 以 用 run 方法 插入 和 删除 数据 人 @。 

我 们 还 需要 用 npm install --save sqlite3 安装 sqlite3 ， 写 作 本 书 时 它 的 版 本 号 是 3.1.8。 

基本 的 数据 库 功 能 已 经 实现 了 ， 接 下 来 我 们 将 它 添加 到 代码 清单 3-2 的 HTTP 路 由 中 。 

下 面 这 上段 代码 添加 了 所 有 方法 ,除了 PosT。( 因为 需要 用 到 readability 模块 , 但 你 还 没有 装 
好 ， 所 以 要 单独 处 理 。) 


代码 清单 3-4 将 Article 模块 添加 到 HTTP 路 由 中 
const express = require('express'); 
Const bodyParser = require('body-parser'); 
const app = express(); 


const Article = require('./db') .Article; 
0 加 载 数 据 库 模块 
abpp.set('Dport'，process.env.PORT || 3000) 















































app.use (bodyParser.json()); 
app.use (bodyParser.urlencoded({ extended: true })); 


app.get('/articles', (req, res, next) => { 
Article.all((err, articles) => { 
if (err) return next (err); 6 获取 所 有 文章 
res.sendl(articles); 


De 


app.get('/articles/:id', (req, res, next) => { 
const id = req.params.id; 
Article.find(id, (err, article) => { 
Lf “(EEE) return next terr)s é 找到 指定 文章 


res.send(article); 
3 
} 


app.delete('/articles/:id', (req, res, next) => { 
const id = req.params.id; 


Article.delete(id, (err) => { 
if (err) return next (err); 6 删除 文章 
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res.send({ message: 'Deleted' }); 
] 
4 


app.listen(app.get('port'), () => { 
console.log('App started on port', app.get ('port')); 
人 


module.exports = app; 

代码 清单 3-4 假设 你 已 经 把 代码 清单 3-3 存 为 了 同一 目录 下 的 dbjs 文件 。Node 会 加 载 那个 
模块 QQ， 然后 用 它 获 取 所 有 文章 介 ， 查 找 特定 文章 合 和 删除 一 篇 文章 @。 

最 后 一 件 事情 是 实现 创建 文章 的 功能 。 因 此 需要 下 载 文章 ， 还 要 用 神奇 的 readability 算法 处 
理 它 们 。 我 们 需要 一 个 来 自 npm 的 模块 。 


3.3.2 ”让 文章 可 读 并 把 它 存 起 来 


RESTful API 已 经 搭建 好 了 ， 数 据 也 可 以 持久 化 到 数据 库 中 了 ， 接 下 来 该 写 代 码 把 网 页 转换 
成 简化 版 的 “阅读 视图 ”了 。 不 过 我 们 不 用 自己 实现 ， 因 为 npm 中 已 经 有 这 样 的 模块 了 。 

在 npm 上 搜索 readability 会 找到 很 多 模块 。 我 们 试 一 下 node-readability ( 写作 本 书 时 是 1.0.1 
版 ),。 用 npm install node-readability --save 安装 它 。 这 个 模块 提供 了 一 个 异步 函数 ， 
可 以 下 载 指定 URL 的 页 面 并 将 HTML 转换 成 简化 版 。 下 面 这 段 代码 演示 了 node-readability 的 用 
法 。 如 果 你 想 试 试 ， 可 以 把 这 里 的 代码 和 代码 清单 3-5 中 的 代码 添加 到 index.js 文件 中 : 

const read = require('node-readability'); 

const Url = 'http://ww.manning.com/cantelon2/'; 

read(url, (err, result)=> { 


// 结果 有 .title 和 .content 
} 


还 可 以 和 数据 库 类 结合 起 来 ， 用 Article.create 方法 保存 文章 : 


read(url, (err, result) => { 
Article.createl 
{ title: result.title, content: result.content }, 
(err, article) => { 
// 将 文章 保存 到 数据 库 中 
} 
); 
过 


打开 index.js, 添加 新 的 app .post 路 由 处 理 器 , 用 上 面 的 方法 实现 下 载 和 保存 文章 的 功能 。 
综合 我 们 上 面 学 到 的 所 有 知识 ， 即 关于 Express 中 的 HTTP POST 和 消息 体 解 析 器 ， 可 以 得 出 下 
面 这 段 代 码 。 
代码 清单 3-5 ”生成 可 读 的 文章 并 保存 


const read = require('node-readability'); 
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f/f/ 代码 清单 3 中 给 出 的 代码 


app.post('/articles', (req, res, next) => { 从 POST 消息 体 
const url = reg.body.url; 中 得 到 URL 
read(url, (err, result) => { 





if (err || !result) res.status(500) .send('Error downloading article'); 
Article.createl 
{ title: result.title, content: result.content }, 用 readability 模块 
(err, article) => { 获取 这 个 URL 指向 
if (err) return next (err); 的 页 面 
res.send('OK'); 
} é 文章 保存 成 功 后 , 发 送 状 
)3 态 码 为 200 的 响应 


9 
这 


在 这 段 代码 中 ， 先 从 POST 消息 体 中 得 到 URL@， 然 后 用 node-readability 模块 获取 这 个 URL 
指向 的 页 面 @@。 用 模型 类 Article 保存 文章 。 如 果 有 错误 ， 将 处 理 权 交 给 Express 的 中 间 件 栈 @; 
人 否则， 将 JSON 格式 的 文章 发 送 给 客户 端 。 

你 可 以 用 --data 参数 给 这 个 例子 发 送 一 个 POST 请 求 : 

curl --data "url=http://manning.com/cantelon2/" http://localhost:3000/articles 

经 过 前 面 这 些 章节 , 我 们 做 了 很 多 工作 : 添加 了 一 个 数据 库 模 块 , 创建 了 一 个 封闭 了 数据 库 
模块 的 JavaScript API， 并 将 它 绑 到 了 RESTful API 上 。 作 为 服务 器 端 开发 人 员 ,你 将 来 会 做 很 多 
这 样 的 工作 。 本 书后 续 章 节 还 会 介绍 数据 库 MongoDB 和 Redis 方面 的 知识 。 

我 们 的 程序 现在 已 经 可 以 保存 文章 了 ,也 可 以 获取 它们 。 为 了 能 够 阅读 这 些 文章 , 还 需要 添 
加 Web 界面 。 


3.4 添加 用 户 界 面 


给 Express 项 目 添加 界面 需要 做 几 件 事 。 首 先是 使 用 模板 引擎 。 我 们 会 简单 地 介绍 一 下 如 何 
安装 模板 引擎 ， 并 用 它 泻 染 模板 。 程 序 还 需要 服务 静态 文件 ， 比 如 CSS。 在 泻 染 模板 和 编写 CSS 
之 前 ， 你 还 需要 了 解 ， 如 何在 必要 时 让 前 面 例子 中 的 路 由 处 理 融 同时 支持 JSON 和 HTML 响应 。 


3.4.1 支持 多 种 格式 


之 前 我 们 用 res .sena () 往 客户 端 发 送 JavaScript 对 象 。 用 cURL 发 送 请 求 时 ，JSON 很 方便 ， 
因为 在 控制 台 里 看 起 来 很 清晰 。 但 在 现实 应 用 中 ,这 个 程序 还 需要 支持 HTML。 怎么 才能 同时 支 
持 这 两 种 格式 呢 ? 

基本 做 法 是 用 Express 的 res . format 方法 。 它 可 以 根据 请 求 发 送 相应 格式 的 响应 。 它 的 用 
法 如 下 所 示 ， 提 供 一 个 包含 格式 及 对 应 的 响应 函数 的 列表 : 


res.format ({ 
html: () => { 
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res.render('articles.ejs', { articles: articles }); 
} 
J.SOni "(站 
res.send(articles); 
} 
}); 


在 这 段 代码 中 ，res .render 会 演 染 view 文件 夹 下 的 模板 articles.ejs。 但 这 需要 安装 模板 引 
擎 并 创建 相应 的 模板 。 


3.4.2 ” 泻 染 模板 3 


模板 引擎 有 很 多 ，EJS ( 能 入 式 JavaScript ) 属于 简单 易学 那 种 。 从 npm 上 安装 EJS 模块 ( 写 
作 本 书 时 EJS 的 版 本 号 是 2.3.1 ): 

npm install ejs --save 

res.render 可 以 演 染 EJS 格式 的 HTML 文件 。 如 果 你 换 掉 代码 清单 3-4 中 app .get 
('Varticles') 路 由 处 理 需 中 的 res .send(articles), 在 浏览 絮 中 访问 http://localhost:3000/ 
articles 时 ， 程 序 应 该 会 尝试 泻 染 articles.ejs。 

接 下 来 在 view 文件 夹 中 创建 模板 articles.ejs， 你 可 以 用 下 面 代 码 清单 中 这 个 完整 的 模板 。 



































代码 清单 3-6 Article 列表 模板 


<% include head %> < 一 @ 包含 另 一 个 模板 
< 
< 多 articles.forEach((article) => { 和 多 > 循环 遍历 每 篇 文 
<1i> 章 并 泻 染 它 
<a href="/articles/<%$= article.id 各 >"> 
<$= article.title %$> 将 文章 的 标题 
</a> 作为 链接 文本 
</1i> 


<% }) %> 
</ul> 
<%$ include foot %> 


文章 列表 模板 在 内 部 和 朋 和 信 了 页 眉 @@ 和 页 脚 模板 , 具体 代码 请 见 下 面 的 代码 清单 。 这 是 为 了 避 
免 在 每 个 模板 文件 中 重复 这 两 部 分 代码 。 文 章 列表 的 循环 遍历 @ 是 用 标准 的 JavaScript 循环 
forEach 实现 的 ， 文 章 的 ID 和 标题 是 用 EJS 的 -$= value gs> 语 法 全 藤 入 到 模板 中 的 。 
下 面 是 页 眉 模 板 示例 ， 保 存 为 views/head.ejs: 
<html> 
<head> 
<title>Later</title> 
</head> 


<body> 
<div class="container"> 


这 是 对 应 的 页 脚 (保存 为 views/foot.ejs ) : 
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</div> 
</body> 
</html> 


res.format 也 可 以 用 来 显示 指定 的 文章 。 从 这 儿 开 始 变 得 有 意思 了 ， 因 为 按照 这 个 程序 的 
要 求 ， 文 章 看 起 来 应 该 简洁 易 读 。 


3.4.3 用 npm 管理 客户 端 依赖 项 


模板 搞定 了 ， 接 下 来 就 该 添加 样式 了 。 我 们 不 用 自己 创建 样式 ， 重 用 已 有 的 样式 会 更 简单 ， 
甚至 这 也 能 用 npm 来 做 ! 热门 的 Bootstrap 客户 端 框 架 也 在 npm 上 ， 把 它 加 到 项 目 中 : 


npm install bootstrap --save 


如 果 看 一 下 node_modules/bootstrap/， 应 该 会 看 到 Bootstrap 项 目的 源码 。 然 后 ， 在 dist/ess 
文件 夹 中 有 来 自 Bootstrap 的 CSS 文件 。 要 使 用 这 些 文件 ， 需 要 让 服务 器 响应 静态 文件 请 求 。 

1. 响应 静态 文件 请 求 

Express 自 带 了 一 个 名 为 sexpress.static 的 中 间 件 , 可 以 给 浏览 器 发 送 客户 端 JavaScript、 
图 片 和 CSS 文件 。 只 要 将 它 指 向 包含 这 些 文件 的 目录 ， 浏 览 需 就 能 访问 到 这 些 文件 了 。 

在 靠近 Express 主 文件 ( index.js ) 的 顶部 ， 有 加 载 项 目 所 需 的 中 间 件 的 代码 : 


app.use (bodyParser.json()); 
abpp.use(bodqyParser.urlencoded({ extended: true })); 


要 加 载 Bootstrap 的 CSS， 用 express .static 将 文件 注册 到 恰当 的 URL 上 : 


app.usel 
'/css/bootstrap.css', 
express.static('node modules/bootstrap/dist/css/bootstrap.css') 
ey 
接 下 来 我 们 把 /css/bootstrap.css 添加 到 模板 中 ， 来 获得 一 些 酷 炫 的 Bootstrap 样式 。views/ 
head.ejs 看 起 来 应 该 是 这 样 的 : 
<html> 
<head> 
<title>later;</title> 
<link rel="stylesheet" href="/css/bootstrap.css"> 
</head> 


<body> 
<div class="container"> 


这 只 是 Bootstrap 的 CSS。 它 还 有 很 多 文件 ， 包 括 图 标 、 字 体 以 及 jQuery 插件 。 你 可 以 往 项 
目 里 添加 更 多 文件 ， 或 者 用 工具 把 它们 打包 成 一 个 文件 ， 让 浏览 器 更 容易 加 载 。 

2. 用 npm 和 客户 端 开发 工具 做 更 多 事情 

前 面 那个 例子 很 简单 ， 只 是 为 了 说 明 可 以 通过 npm 使 用 浏览 器 端的 库 。 Web 开发 人 员 一 般 
会 下 载 Bootstrap 的 文件 ， 然 后 手动 添加 到 项 目 中 。 那 些 制作 简单 的 静态 站 的 Web 设计 师 通常 都 
是 这 么 做 的 。 
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但 时 党 的 前 端 开发 人 员 不 仅 用 npm 下 载 这 些 库 ,还 会 用 npm 在 客户 端 JavaScript 中 加 载 它 们 。 
借助 Browserify 和 Webpack， 可 以 释放 出 npm 安装 器 和 加 载 依赖 项 的 require 的 全 部 力量 。 想 
象 一 下 ， 不 仅 在 写 Node 代码 时 ， 在 做 前 端 开 发 时 也 可 以 敲 和 人 const React = require('react') 
这 样 的 代码 ! 这 超出 了 本 章 的 范围 ， 不 过 你 应 该 感受 到 了 吧 ， 把 源 自 Node 的 编程 技术 跟前 端 开 
发 结合 起 来 将 释放 出 多 么 大 的 能 量 ! 
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口 用 npm init 和 Express 可 以 快速 搭建 出 一 个 Node Web 应 用 程序 。 

口 npm install 是 安装 依赖 项 的 命令 。 

口 可 以 用 Express 制作 带 有 RESTful API 的 Web 程序 。 

口 选择 合适 的 数据 库 系统 和 数据 库 模 块 需要 你 根据 自己 的 需求 做 一 些 前 期 调研 。 
口 对 于 小 项 目 来 说 ，SQLite 很 好 用 。 

口 在 Express 中 用 EJS 泻 染 模板 很 容易 。 

口 Express 支持 很 多 种 模板 引擎 ， 包 括 Pug 和 Mustache。 
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接 下 来 可 以 更 深入 地 学 习 服务 器 端 开 发 了 。 在 服务 器 端 代 码 之 外 ，Node 还 开辟 了 一 块 很 
重要 的 市 场 : 前 端 构建 系统 。 在 这 一 部 分 ， 我 们 将 会 介绍 如 何 用 Webpack 和 Gulp 开始 新 项 目 ， 
还 会 介绍 儿 个 最 流行 的 Web 框架 ， 并 从 多 个 视角 来 对 它们 进行 比较 ， 以 便 你 找 出 最 适合 自己 项 
目的 框架 。 

第 6 章 一 整 章 都 是 讲 如 何 用 Connect 和 Express 模块 搭建 Web 程序 ， 供 感 兴 趣 的 读者 深 入 
学 习 。 另 外 书 中 还 用 一 章 集 中 讲 了 模板 和 数据 库 的 使 用 。 

为 了 保证 Node 全 栈 Web 开发 知识 的 完整 性 ， 本 书 还 介绍 了 测试 和 部 署 ， 让 你 可 以 为 自己 
的 第 一 个 Node 程序 做 好 准备 。 











剖 站 构建 系统 








本 章 内 容 

口 用 npm 脚本 简化 复杂 的 命令 

口 用 Gulp 管理 重复 性 任务 

口 用 Webpack 打包 客户 端 Web 程序 








在 现代 Web 开发 中 , 用 Node 来 运行 工具 和 服务 的 情况 越 来 越 多 。 作 为 Node 程序 员 ， 你 可 
能 要 负责 配置 和 维护 这 些 工具 。 作 为 全 栈 开 发 人 员 , 你 可 能 想 用 这 些 工具 来 创建 速度 更 快 、 更 可 
靠 的 Web 程序。 本章 将 会 介绍 如 何 使 用 npm 脚本 、Gulp 和 Webpack 搭建 易于 维护 的 项 目 。 

使 用 前 端 构 建 系统 的 好 处 非常 多 。 它们 可 以 帮 你 写 出 更 易 读 懂 的 并 具有 前 瞻 性 的 代码 。 因 为 
可 以 用 Babel 转译 ， 所 以 无 须 担 心 浏览 器 对 ES2015 的 支持 。 另 外 ， 因 为 能 生成 源码 映射 ， 所 以 
你 仍然 可 以 进行 基于 浏览 器 的 调试 。 

首先 简要 介绍 基于 Node 的 前 端 开 发 。 之 后 我 们 会 给 出 一 些 涉及 现代 前 端 技术 的 例子 ， 比 如 
在 项 目 中 使 用 React。 


4.1 了 解 基于 Node 的 前 端 开 发 


最 近 这 段 时 间 ， 前 端 和 后 台 开 发 已 经 开始 融合 了 ， 他 们 都 在 用 npm 分 发 JavaScript。 也 就 是 
说 ，npm 既 用 于 前 端 模块 ， 比 如 React， 也 用 于 后 台 代 码 ， 比 如 Express。 但 有 些 模块 的 边界 比较 
模糊 ， 比 如 lodash， 它 是 一 个 通用 库 ， 既 可 以 用 在 Node 中 ， 也 可 以 用 在 浏览 器 中 。 经 过 仔细 打 
包 ， 一 个 模块 可 以 同时 用 在 Node 和 浏览 器 中 ， 并 且 项 目 里 的 依赖 项 也 可 以 用 npm 管理 。 

也 有 专门 针对 客户 端 开发 的 模块 系统 ， 比 如 Bower。 你 可 以 接着 用 这 些 工 具 ， 但 作为 Node 
开发 人 员 ， 应 该 优先 考虑 npm。 

然而 前 端 开发 人 员 不 只 是 用 Node 来 做 包 分 发 , 那些 能 生成 可 移植 的 、 向 后 兼容 的 JavaScript 
的 工具 也 越 来 越 受 他 们 的 青睐 。 比 如 像 Babel 这 种 能 将 ES2015 转换 成 支持 更 广泛 的 ES5 代码 的 
转译 器 。 还 有 像 UglifyJS 这 样 的 缩 码 器 ， 以 及 像 ESLint 这 样 的 用 来 检验 代码 正确 性 的 剪 毛 器 等 。 
测试 引擎 也 有 好 多 是 Node 驱动 的 。 在 Node 进程 中 既 可 以 运行 UI 代码 的 测试 ， 也 可 以 用 
Node 脚本 驱动 运行 在 浏览 需 中 的 测试 。 
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开发 人 员 通 常会 同时 使 用 这 些 工具 。 在 开始 摆弄 转译 器 、 缩 码 器 、 剪 毛 央 和 测试 引擎 后， 你 
需要 借助 某 种 手段 记录 一 下 构建 过 程 是 如 何 进行 的 。 有 些 项 目 用 npm 脚本 ， 有 些 用 Gulp 或 
Webpack。 本 章 将 逐一 介绍 这 些 方法 ， 还 会 涉及 一 些 相关 的 最 佳 实践 。 


4.2 用 npm 运行 脚本 


Node 有 npm， 而 npm 能 运行 脚本 。 因 此 ， 合 作者 或 用 户 要 能 够 调用 npm start 和 npm test 
之 类 的 命令 。 在 项 目的 package.json 文件 中 ， 有 个 scripts 属性 ， 可 以 在 那里 指定 自己 的 npm 


start 命令 : 








{ 


Woh an ol er 
"start": "node server.js" 


}, 


} 

node server.js 是 默认 的 start 命令 ， 所 以 如 果 只 是 要 做 这 个 ， 从 技术 角度 讲 上 面 的 定义 
是 可 以 省 略 的 。 当 然 ， 别 忘 了 创建 serverjs 文件 。 我 们 一 般 都 会 定义 test 属性 ， 因 为 可 以 把 测试 
框架 作为 依赖 项 ， 然 后 用 npm test 来 运行 测试 脚本 。 比 如 说 ， 你 选 了 Mocha 来 做 测试 ， 并且 已 
经 用 npm install --save-dev 装 好 了 。 如 果 在 package.json 中 添加 下 面 的 语句 ， 就 不 用 全 局 安 
装 Mocha 了 : 















































{ 


veerEIDte TE: 过 
"test": "./node modules/.bin/mocha test/*.js" 


}, 


i 
注意 看 一 下 ， 这 个 例子 里 的 参数 是 传 给 了 Mocha。 也 可 以 在 运行 npm 脚本 时 用 两 个 连 字 符 
传人 参数 : 
npm testo -- test/*.js 


表 4-1 给 出 了 一 些 常 用 的 npm 命令 。 




















表 4-1 npm 命令 
命令 packagejson 属性 应 用 案例 
start scripts.start 启动 Web 应 用 服务 器 或 Electron 程序 
stop SCriDtS:Stob 停 掉 Web 应 用 服务 器 
SEE 运行 stop， 然 后 运行 restart 
Install, scripts.install, 在 安装 了 包 之 后 运行 本 地 构建 命令 。 注意 ，postinstall 只 
postinstall scripts.postinstall 


能 通过 npm run postinstall 运行 
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还 有 很 多 可 用 的 命令 ， 包 括 在 发 布 包 之 前 进行 清理 的 命令 ， 以 及 用 于 包 版 本 迁移 时 的 前 置 / 
后 置 命令 。 但 对 于 大 多 数 Web 开发 任务 来 说 ，start 和 test 就 够 用 了 。 

使 用 npm 时 ， 可 能 会 有 很 多 你 想 要 定义 的 任务 并 没有 恰当 的 命令 名 支持 。 比 如 说 ， 你 正在 
处 理 一 个 用 ES2015 写 的 项 目 ， 但 是 你 想 把 它 转译 成 ES5， 这 时 可 以 用 npm run。 下 一 节 会 有 个 
教程 教 你 如 何 创建 一 个 能 够 构建 ES2015 文件 的 新 项 目 。 


4.2.1 创建 定制 的 npm 脚本 


npm run 命令 等 同 于 npm run-script, 用 npm run script-name 可 以 运行 任何 脚本 。 
我 们 来 看 一 下 如 何 做 一 个 用 Babel 构建 客户 端 脚本 的 命令 。 

从 创建 新 项 目 开始 ， 然 后 安装 必要 的 依赖 项 : 

mkdir es2015-example 

cd es2015-example 

npm init -y 

npm install --save-dev babel-cli babel-preset-es2015 

echo '{ "presets": "es2015"] }' > .babelrc 


现在 你 应 该 有 了 一 个 具有 基本 Babel ES2015 工具 和 插件 的 Node 项目 。 接 下 来 打开 packagejson， 
在 scripts 下 面 添加 babel 属性 。 

它 应 该 运行 已 经 安装 到 node _ modules/.bin 文件 夹 下 的 脚本 : 

"babel": "./node modules/.bin/babel browser.js -d build/" 

下 面 是 用 ES2015 语法 写 的 代码 ， 将 它 存 为 browserjs 文件 : 


class Example { 
render() { 
return '<hl>Example</hl>'; 
} 
} 





















































const example = new Example(); 
console.log(example.render ()); 


运行 npm run babel 斌 一下。 如 果 配 置 都 没 问 题 ， 应 该 会 有 一 个 build 文件 来， 里 面 有 转 
译 过 的 browserjs。 打 开 这 个 文件 ， 看 看 里 面 是 不 是 ES5 的 代码 。 因 为 太 长 了 ， 我们 就 不 放 到 这 
里 来 了 ,文件 顶部 应 该 有 var_createclass 这 样 的 代码 。 

如 果 构 建 项 目 时 只 需要 做 这 件 事 ， 那 么 可 以 将 这 个 任务 的 名 称 改 为 builda。 但 一 般 会 加 上 
UsglifyJS : 


























npm i --save-dev uglify-es 

可 以 用 node modules/.bin/uglifyjs 调用 UglifyJS， 在 scripts 下 添加 名 为 uglify 的 属性 : 

./node_modules/.bin/uglifyjs build/browser.js -o build/browser.min.js 

现在 应 该 可 以 运行 npm run uglify 命令 了 。 这 些 命令 可 以 组 合 到 一 起 。 在 scripts 下 添 
加 一 个 名 为 buila 的 属性 ， 让 它 调用 这 两 个 任务 : 
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eb pl Wi 


运行 npm run build 会 执行 那 两 个 脚本 。 用 这 个 简单 
这 是 因为 Babel 和 UglifyJS 都 可 以 作为 命令 行 脚本 执行 ， 并 | 

















"npm run babel && npm run uglify" 








的 命令 可 以 组 合 多 个 前 端 打包 工具 。 
昌都 接受 命令 行 参 数 ， 所 以 很 容易 放 


到 一 行 里 添加 到 package.json 中 。Babel 支持 配置 文件 ， 我 们 可 以 在 .babelrc 文件 中 实现 更 复杂 的 





行为 ， 你 应 该 在 之 前 的 命令 中 见 过 这 个 文件 了 。 
4.2.2 配置 前 端 构建 工具 
在 使 用 npm 脚本 时 ， 通 常 有 三 种 配置 前 端 构建 工具 的 方法 。 























如 果 构 建 过 程 复杂 ,要 做 文件 的 复制 、 合 并 和 转移 




















口 指定 命令 行 参 数 。 比如 . /node_modules/.bin/ uglify --source-mapo 

口 针对 项 目 创建 配置 文件 ， 将 参数 放 在 这 个 文件 中 。Babel 和 ESLint 经 常 这 么 干 。 
口 将 配置 参数 添加 到 package.json 中 。Babel 也 支持 这 种 方式 。 
等 很 多 事情 怎么 办 ? 可 以 创建 一 个 shell 脚 
本 ， 然 后 用 npm 脚本 调用 它 。 但 如 果 你 用 JavaScript， 还 有 更 巧妙 的 办 法 。 很 多 构建 系统 都 提供 


了 JavaScript API， 以 实现 自动 化 构建 。 下 一 节 会 全 面 介绍 一 个 这 样 的 方案 : Gulp。 


4.3 ”用 Gulp 实现 自动 化 


Gulp 是 基于 流 的 构建 系统 。 我 们 可 以 通过 对 这 些 流 的 引导 来 创建 构建 过 程 ， 除 了 转译 和 缩 



































码 ， 还 能 做 很 多 事情 。 想 象 一 个 项 目 ， 后 台 管 理 区 是 用 Angular 做 的 ,公开 区 域 是 基于 React 的 。 


两 个 子 项 目的 构建 需求 都 是 一 样 的 。 借助 Gulp, 我 们 可 以 重用 某 些 阶 段 的 构建 过 程 。 











了 两 个 构建 过 程 的 例子 ， 它 们 有 共享 的 功能 。 


基于 Angular 的 管理 区 域 


» admin/index.js 








Browserify | => build/admin.js Re 
* build/admin.js 
* lib/shared.js 
合并 一 build/admin js 合并 








*。build/admin.js 


=> assets/admin.min.js 














。CSS 精 3 
外 更 图 所 | .admin 和 public 共 享 的 品牌 你 到 





图片 


基于 React 的 公共 区 域 


» public/index.js 
=> build/public.js 





图 4-1 给 出 








* build/public.js 
。 lib/shared.js 
=> build/public.js 








。build/public.js 
=> assets/public.min.js 








“视网膜 
“ CSS 精灵 表 
“admin 和 public 共 享 的 品牌 


图 4-1 功能 共享 的 两 个 构建 过 程 
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Gulp 之 所 以 能 实现 高 度 重用 ， 主 要 归功 于 两 项 技术 : 使 用 插件 和 自 定义 构建 任务 。 就 像 
图 4-1 展示 的 那样 ,构建 过 程 是 一 个 流 ， 所 以 这 些 任务 和 插件 是 可 以 一 个 接 一 个 拼 在 一 起 的 。 比 如 
说 ， 对 于 前 面 那 个 例子 中 的 React 部分， 可 以 用 Gulp Babel 和 Gulp 自 带 的 文件 聚集 方法 gulp .src 
处 理 : 
gulp.src('public/index.jsx') 
.pipe (babel({ 
presets: ['es2015', 'react'] 
小 站 


.Dipe(minify()) 
.pipe(gulp.dest ('build/public.js')); 


要 把 文件 合并 阶段 添加 到 这 个 链条 上 也 十 分 容易 。 在 深入 探讨 语法 之 前 , 我 们 先 看 看 如 何 配 
置 好 一 个 小 型 的 Gulp 项 目 。 









































4.3.1 把 Gulp 添加 到 项 目 中 


添加 Gulp 需要 用 npm 安装 gulp-cli 和 gulp 两 个 包 。 很 多 人 会 把 gulp-cli 安装 在 全 局 环境 中 ， 
这 样 只 要 输入 gulp 就 可 以 运行 Gulp 处 方 了 。 如 果 你 之 前 在 全 局 环境 中 安装 过 gulp， 应 该 运行 
npm rm --global gulp 删除 它 。 在 下 面 这 段 代 码 中 ， 全 局 安装 gulp-cli， 并 创建 一 个 带 有 Gulp 
开发 依赖 项 的 新 Node 项 目 : 

npm 1 =~-global :gulPp=CI]i 

mkdir gulp-example 

cd gulp-example 

npm init -y 

npm i -save-dev gulp 


接着 创建 gulpfile.js: 
touch gulpfile.js 


打开 这 个 文件 。 现在 用 Gulp 构建 一 个 小 型 的 React 项 目 。 这 里 会 用 到 gulp-babel、gulp-sourcemaps 
和 gulp-concat: 











npm i --save-dev gulp-sourcemaps gulp-babel babel-preset-es2015 
npm i --save-dev gulp-concat react react-dom babel-preset-react 


往 项 目 里 添加 Gulp 插件 时 , 记得 把 npm 命令 中 的 参数 - -save 换 成 --save-dev。 如果 为 了 
试验 新 揪 件 并 想 把 它们 印 掉 ， 可 以 用 npm uninstall --save-dev 把 它们 从 .node modules 
里 删 控 ， 同 时 更 新 package.json 文件 。 





























4.3.2 Gulp 任务 的 创建 及 运行 


创建 Gulp 任务 需要 在 gulpfilejs 中 编写 Node 代码 , 调用 Gulp 的 API。Gulp 的 API 可 以 做 很 
多 事 ， 比 如 查找 文件 ， 把 对 文件 进行 某 种 转换 的 插件 拼 到 一 起 等 。 
你 可 以 按 这 个 例子 试 一 下 : 打开 gulpfile.js 设置 一 个 构建 任务 , 用 gulp .src 查找 JSX 文件 ， 
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用 Babel 人 处理 ES2015 和 React， 然 后 把 这 些 文件 拼 到 一 起 。 代 码 如 下 所 示 。 
代码 清单 4-1 用 Babel 处 理 ES2015 和 React 的 gulpfile 


const gulp = require('gulp'); 

const sourcemaps = require('gulp-sourcemaps'); < 一 一 像 加 载 标准 Node 模块 那样 
const babel = require('gulp-babel'); 加 载 Gulp 插件 

const concat = require('gulp-concat'); 


用 Gulp 自 带 的 文件 聚集 工具 gulp. src 





gulp.task('default', () => { 查找 所 有 的 React jsx 文件 
return gulp.src('app/*.jsx') < 一 一 
.Dipe(sourcemaps .init()) 十 一 II 大 > 四 | 
把 所 有 源码 .pipe (babel ({ et 
文件 拼 到 一 presets: ['es2015', 'react'] < 源码 映射 
个 alljs 中 } ) ) 使 用 ES2015 和 React (JSX) 
.pipe(concat ('all.js')) 配置 gulp-babel 
.pipe(sourcemaps .write('.')) < 一 
.pipe (gulp.dest ('dist')); 将 所 有 文件 放 到 单独 写 入 源码 
) ) ; dist/ 目 录 下 映射 文件 






































代码 清单 4-1 中 出 现 了 几 个 用 来 捕获 、 人 处 理 和 写 文件 的 Gulp 插件 。 首 先是 用 文件 聚集 找到 
所 有 输入 文件 ， 然 后 用 gulp-sourcemaps 插件 为 客户 端 调试 采集 源码 映射 指标 。 注 意 ， 源 码 映 射 
需要 两 个 阶段 : 一 个 阶段 是 声明 想 要 用 源码 映射 ， 另 一 个 阶段 是 写 源码 映射 文件 。 与 此 同时 , 配 
置 gulp-babel 用 ES2015 和 React 处 理 文件 。 

在 终端 里 输入 gulp 就 可 以 运行 这 个 Gulp 任务 。 

在 这 个 例子 里 ， 所 有 文件 转换 都 是 一 个 插件 做 的 。 碰 巧 了 ，Babel 既 能 转译 React， 也 能 将 
ES2015 转换 成 ES5。 转 换 完成 后 ， 用 gulp-concat 插件 把 文件 合 到 一 起 。 现 在 所 有 转译 都 做 完了 ， 
可 以 写 源码 映射 了 。 最 终 的 构建 结果 可 以 放 到 dist 文件 夹 下 。 

再 创建 一 个 名 为 app/index.jsx 的 文件 ， 就 可 以 试验 一 下 Gulp 了 。 可 以 用 下 面 这 段 JSX 代码 : 


import React from 'react'; 
import ReactDOM from 'react-dom'; 






































ReactDOM.render ( 

<hl>Hello, world!</h1>, 

document .getElementById('example') 
入 


在 Gulp 中 , 用 JavaScript 表示 构建 阶段 很 容易 。 并 且 我 们 可 以 用 gulp.task() 往 这 个 文件 
里 添加 自己 的 任务 。 这 些 任 务 通常 都 遵循 相同 的 模式 。 

(1) 源 文件 一 一 收集 输入 文件 。 

(2) 转译 一 一 让 它们 依次 通过 一 个 个 对 它们 进行 转换 的 插件 。 

(3) 合并 一 一 把 这 些 文件 合 到 一 起 ,创建 一 个 整体 构建 文件 。 

(4) 输出 一 一 设 定 文件 的 目标 地 址 或 移动 输出 文件 。 

在 前 面 那 个 例子 中 ，sourcemaps 是 个 特例 ， 因 为 它 需 要 两 次 bipe: 第 一 次 是 配置 ， 最 
后 一 次 是 输出 文件 。 这 是 因为 源码 映射 需要 把 最 初 的 代码 行 数 映射 到 应 该 转译 构建 后 的 代码 行 
数 上 。 
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4.3.3 监测 变化 




















前 端 开 发 人 员 想 要 的 最 后 一 个 东西 是 构建 /刷新 循环 。 精 简 构建 过 程 最 简单 的 办 法 就 是 用 
Gulp 插件 监测 文件 系统 的 变化 。 但 也 有 备 选 方案 。 有 些 库 跟 热 重 载 配合 得 很 好 ， 并 且 更 通用 的 
DOM 和 基于 CSS 的 项 目 也 很 适合 LiveReload 项 目 。 

作为 示例 ， 你 可 以 把 gulp-watch 添加 到 代码 清单 4-1 中 给 出 的 项 目 里 。 将 这 个 包 添 加 到 项 
目 中 : 

npm i --save-dev gulp-watch 
别 忘 了 在 gulpfilejjs 中 加 载 它 : 

const watch = require('gulp-watch'); 
添加 监测 任务 ， 让 它 调用 前 面 那 个 例子 中 的 默认 任务 : 


gulp.task('watch', () = 
watch("'app/**,jsx', ( 


























党 -外 
)y =>-gulpetartltdefault))y 
已) 


这 段 代 码 定 义 了 一 个 名 为 watcn 的 任务 ， 然 后 用 watch () 监测 React JSX 文件 的 变化 。 只 
要 有 文件 发 生 了 变化 , 默认 的 构建 任务 就 会 运行 。 只 需 稍稍 修改 , 这 个 处 方 就 可 以 用 来 构建 SASS 
文件 、 优 化 图 片 ， 以 及 做 需要 在 前 端 项 目 上 做 的 很 多 事情 。 


4.3.4 ”在 大 项 目 中 把 任务 分 散 到 不 同文 件 中 


项 目 规 模 变 大 后 ， 一 般 会 需要 更 多 的 Gulp 任务 。 最 终 会 出 现 一 个 大 到 难以 理解 的 长 文件 ， 
如 果 把 代码 分 解 成 不 同 的 模块 ， 就 可 以 解决 这 个 问题 。 

你 已 经 看 到 了 ，Gulp 是 用 Node 的 模块 系统 来 加 载 插件 的 。 没 有 特殊 的 插件 加 载 系统 ， 就 是 
标准 模块 。 我 们 也 可 以 用 Node 的 模块 系统 分 割 超 长 的 gulpfile 文件 ， 以 便于 维护 。 可 以 按 如 下 
步 又 来 使 用 分 散 的 文件 。 

(1) 创建 一 个 名 为 gulp 的 文件 夹 以 及 一 个 名 为 tasks 的 子 目 录 。 

(2) 在 各 个 文件 中 用 gulp .task() 语 法 定义 任务 ， 最 好 是 每 个 任务 放 一 个 文件 。 

(3) 创建 一 个 名 为 gulp/indexjs 的 文件 ， 在 其 中 加 载 所 有 的 Gulp 任务 文件 。 

(4) 在 gulpfile.js 中 引入 这 个 gulp/index.js 文件 。 

目录 结构 看 起 来 应 该 类 似 这 样 : 

gulpfile.js 

gulp/ 

gulp/index.js 


gulp/tasks/development-build.js 
gulp/tasks/production-build.js 


我 们 可 以 用 这 个 办 法 组 织 复 杂 的 构建 任务 ， 还 可 以 跟 gulp-help 模块 搭配 起 来 用 。gulp-help 
模块 可 以 生成 任务 文档 , 运行 gulp help 可 以 显示 每 个 任务 的 帮助 信息 。 在 你 需要 团队 协作 时 ， 
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或 者 要 在 很 多 使 用 Gulp 的 项 目 中 切换 时 ， 就 能 体会 到 这 个 插件 的 价值 了 。 图 4-2 是 gulp help 
输出 的 样子 。 
~/Projects/world-domination: gulp help 


[10:33:38] Using gulpfile ~/Projects/world-domination/gulpfile.js 
[10:33:38] Starting 'help'... 


Usage 
gulp [TASK] [OPTIONS...] 


Available tasks 
help Display this help text. 
version prints the version. Aliases: v, V 





[10:33:38] Finished "help" after 1.2 ms 
图 4-2 gulp-help 输出 样 例 


Gulp 是 一 个 通用 的 项 目 自动 化 工具 。 它 适合 管理 项 目 里 的 跨 平 台 清理 脚本 ， 比 如 运行 复杂 
的 客户 端 测试 或 者 为 数据 库 提 供 固 定 的 测试 环境 。 尽 管 它 也 可 以 构建 客户 端 资 产 , 但 不 如 专门 做 
这 些 事情 的 工具 ， 也 就 是 说 相 较 之 下 ，Gulp 需要 更 多 的 代码 和 配置 来 定义 那些 任务 。Webpack 
就 是 这 样 的 工具 ， 专 注 于 打包 JavaScript 和 CSS 模块 。 下 一 节 会 介绍 如 何 用 Webpack 构建 React 
项 目 。 

















4.4 用 Webpack 构建 Web 程序 


Webpack 是 专门 用 来 构建 Web 程序 的 。 比 如 说 , 你 要 跟 一 位 设计 师 合 作 , 他 已 经 给 一 个 单 页 
Web 程序 创建 了 静态 站 ， 而 你 要 改写 它 ， 构 建 更 高 效 的 CSS 和 ES2015 JavaScript 代码 。 用 Gulp 
时 ， 写 JavaScript 代码 是 为 了 驱动 构建 系统 ， 所 以 会 涉及 写 gulpfile 和 构建 任务 。 而 用 Webpack 
时 ， 写 的 是 配置 文件 ,用 插件 和 加 载 器 添加 新 功能 。 有 时 候 不 需要 额外 的 配置 : 在 命令 行 里 输入 
webpack， 将 源 文件 的 路 径 作为 参数 ， 它 就 能 构建 项 目 。4.4.4 节 中 有 一 个 这 样 的 例子 。 

Webpack 的 优势 之 一 是 更 容易 快速 搭建 出 一 个 支持 增 量 式 构建 的 构建 系统 。 如 果 配 置 成 文件 
发 生变 化 时 自动 构建 ，Webpack 不 会 因为 一 个 文件 发 生变 化 而 重新 构建 整个 项 目 。 所 以 它 的 构建 
更 快 ， 也 更 好 理解 。 

本 节 将 会 演示 如 何 用 Webpack 构建 一 个 小 型 的 React 项 目 。 我 们 先 来 定义 Webpack 所 用 的 术语 。 


4.4.1 使 用 打包 器 和 插件 


在 创建 Webpack 项 目 之 前 , 先 来 明确 一 些 术语 。Webpack 插件 是 用 来 改变 构建 过 程 的 行为 的 。 
这 些 行为 包括 自动 将 静态 资源 上 传 到 Amazon S3 或 去 掉 输 出 中 重复 的 文件 等 。 

与 插件 相反 ， 加 载 器 是 用 来 转换 资源 文件 的 。 比 如 将 SASS 转换 为 CSS ， 或 者 将 ES2015 转 
换 为 ES5。 加 载 器 是 函数 ， 负 责 将 输入 的 源 文本 转换 为 特定 的 文本 输出 。 它 们 既 可 以 是 异步 的 ， 
也 可 以 是 同步 的 。 插 件 是 可 以 挂 接 到 Webpack 更 底层 API 的 类 的 实例 。 

如 果 需 要 转换 React 代码 、CoffeeScript、SASS 或 其 他 转译 语言 ， 就 用 加 载 器 。 如 果 需 要 调 
整 JavaScript， 或 用 某 种 方式 处 理 文 件 ， 就 用 插件 。 
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下 一 节 会 介绍 如 何 用 Babel 加 载 器 将 一 个 React ES2015 项 目 转换 成 对 浏览 器 友好 的 包 。 


4.4.2 配置 和 运行 Webpack 
我 们 要 重新 创建 代码 清单 4-1 中 的 那个 例子 ， 不 过 这 次 改 用 Webpack。 首 先 要 安装 React: 


mkdir webpack-example 

npm init -y 

npm install --save react react-dom 

npm install --save-dev webpack babel-loader babel-core 

npm install --save-dev babel-preset-es2015 babel-preset-react 


最 后 一 条 命令 安装 了 Babel 的 ES2015 插件 和 用 于 Babel 的 React 转换 器 。 接 下 来 需要 创建 
webpack.config.js， 我 们 要 在 这 个 文件 里 告诉 Webpack 去 哪里 找 输入 文件 ， 把 输出 写 到 哪里 ， 以 
及 用 哪些 加 载 器 。 我 们 要 对 React 使 用 babel-loader， 还 要 对 它 做 些 额外 的 配置 ， 代 码 如 下 所 示 。 


代码 清单 4-2 一 个 webpack.config .js 文件 
const path = require('path'); 
Const webpack = require('webpack'); 

















module.exports = { 输入 文件 
entry: './app/index.jsx', < 二 一 输出 文件 
output: { path: dirname，filename: 'dist/bundle.js' }, < 十 一 一 
module: { 
loaders: |[ 
{ 匹配 所 有 的 
test /jeR?S/; < 一 1 JSX 文 件 


loader: 'babel-loader', 


exclude: /node_modules/, 
query: { 使 用 Babel ES2015 和 


presets: ['es2015', 'react'] < React 插件 
} 
} 
] 
js 
于 


这 个 配置 文件 包含 了 成 功 构建 一 个 以 ES2015 写 的 React 程序 所 需 的 一 切 。 里 面 的 配置 都 很 
直 白 : 定义 一 个 entry, 同时 加 载 程 序 的 主 文件 。 然后 指定 输出 应 该 写 到 哪里 。 如 果 这 个 文件 不 
存在 ，Webpack 会 创建 它 。 接 着 定义 一 个 加 载 器 ， 并 用 test 把 它 关 联 到 一 个 文件 聚集 搜索 上 。 
最 后 ， 设 定 加 载 带 的 选项 。 在 这 个 例子 中 ， 这 些 选 项 加 载 了 ES2015 和 React Babel 插件 。 

我 们 还 需要 一 个 React JSX 文件 app/index.jsx， 可 以 用 4.3.2 节 中 的 代码 。 现 在 运 
行 .node modules/.bin/webpack， 就 会 得 到 一 个 带 着 React 依赖 项 的 ES5 版 文件 。 


4.4.3 用 Webpack 开发 服务 器 


如 果 不 想 在 React 文件 发 生变 化 后 自己 手动 重新 构建 项 目 ,可 以 用 Webpack 开发 服务 器 。 请 
在 本 书 源码 中 找到 webpack-hotload-example ( ch04-front-end/webpack-hotload-example )。 这 个 小 
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Express 服务 器 会 在 文件 发 生变 化 后 运行 Webpack， 然 后 将 变化 后 的 资源 文件 提供 给 浏览 器 。 为 
了 不 跟 主 服务 器 冲突 ， 你 应 该 把 它 跑 在 另外 一 个 端口 上 ， 也 就 是 说 在 开发 过 程 中 ，script 标签 
要 指向 这 个 开发 服务 器 提供 的 URL 上 。 这 个 服务 器 会 构建 资源 文件 ， 但 输出 会 放 在 内 存 里 ， 而 
不 是 Webpack 的 输出 文件 夹 里 。webpack-dev-server 也 可 以 用 来 做 模块 热 加 载 ， 这 与 LiveReload 
服务 器 的 用 法 类 似 。 

按 下 面 的 步骤 把 webpack-dev-server 添加 到 项 目 中 。 

(1) 用 npm i --save-dev webpack-dev-server@ 1.14.1 安装 webpack-dev-server。 

(2) 在 webpack.config.js 的 output 属性 中 添加 一 个 publicPath 选项 。 

(3) 在 构建 目录 下 添加 index.html 文件 ， 在 这 个 文件 中 加 载 打 包 后 的 JavaScript 和 CSS 文件 ， 
注意 URL 中 的 端口 是 下 一 步 中 指定 的 那个 端口 。 

(4) 带 着 你 想 要 用 的 选项 运行 服务 器 。 比 如 webpack-dev-server --hot --inline--content 
-base dist/ --port 3001。 

(5) 访问 http://localhost:3001/ 加 载 这 个 程序 。 

打开 代码 清单 4-2 中 的 那个 webpack.config.js， 修 改 output 属性 ， 加 一 个 publicPath: 





























output: { 
path: path.resolve( dirname, 'dist'), 
filename: 'bundle.js', 
publicPath: '/assets/' 

} 


创建 文件 dist/index.html1， 代 码 如 下 所 示 。 





代码 清单 4-3 ”用 于 React Web 程序 的 HTML 模板 示例 
<!DOCTYPE html> 
<html lang="en"> 
<head> 
<meta charset="UTF-8"> 
<title>Warning: Dev server only</title> 


</head> 
<body> 
<div id="example"></div> pp 
<script src="/assets/bundle.js"></script> 文件 的 路 径 
</body> 
</html> 
接着 打开 package.json， 在 scripts 下 添加 运行 Webpack 服务 器 的 命令 : 
"SGripES": 区 
"server:dev": "webpack-dev-server --hot -inline 


--Content-base dist/ --port 3001" 
} 


选项 --hot 是 指 服务 器 dev 要 用 模块 热 重 载 。 也 就 是 说 只 要 修改 了 React 文 件 app/index.js， 
浏览 器 就 会 刷新 。- -inline 选项 就 是 用 来 指定 刷新 机 制 的 。 内 藤 刷 新 (inline refresh ) 是 指 服务 需 
dev 会 在 打包 文件 中 航 入 代码 来 管理 刷新 。 另 外 还 有 一 种 是 把 整个 页 面 放 到 iframe 中 的 过 am 选项 。 
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运行 服务 器 dev: 
npm run server:deyv 


运行 Webpack 开发 服务 器 会 触发 构建 过 程 ， 并 启动 一 个 监听 端口 3001 的 服务 器 。 可 以 在 浏 
览 器 中 访问 http://localhost:3001 测试 一 下 。 


基于 React， 以 及 包含 AngularJS 在 内 的 其 他 框架 ， 都 有 相应 的 热 重 载 项 目 。 一 些 框 架 还 
考虑 到 了 数据 流 ， 比 如 Redux 和 Relay， 也 就 是 说 在 代码 被 刷新 后 状态 还 能 保留 下 来 。 这 是 代 
码 重 载 的 理想 方式 ， 因 为 你 不 用 为 了 重 现 UI 的 状态 而 把 之 前 的 步骤 再 做 一 遍 。 

不 过 我 们 给 的 这 个 例子 不 是 专门 针对 React 的 ,只 是 为 了 让 你 对 Webpack 开发 服务 器 有 个 
认识 。 请 通过 实验 自行 找 出 最 适合 你 的 项 目的 配置 。 


4.4.4 加 载 CommonJS 模块 和 静态 资源 


介绍 完 在 React 和 Babel 项 目 上 的 用 法 ， 下 面 再 来 讲 讲 在 更 加 普通 的 CommonJS 项 目 上 使 用 
Webpack 的 情况 。 无 须 CommonJS 浏览 右 垫 片 ，Webpack 就 能 提供 我 们 需要 的 一 切 。 它 甚至 能 加 
载 CSS 文件 。 

1. Webpack 和 CommonJS 

在 Webpack 中 使 用 CommonJS 模块 语法 不 需要 做 任何 配置 .比如 说 ,有 个 文件 用 了 require: 


const hello = require('./hello'); 























hello(); 
而 另 一 个 定义 了 hello 函数 : 


modqule .exports = function() { 
return 'hello'; 


je 
然后 只 需要 一 个 Webpack 配置 文件 来 定义 入 口 (第 一 段 代 码 ) 和 构建 目标 路 径 : 


const path = require('path'); 
const webpack = require('webpack'); 








module.exports = { 
entry: './app/index.js', 
output: { path: _ dirname, filename: 'dist/bundle.js' }, 


六 
从 这 个 文件 里 就 能 看 出 Gulp 和 Webpack 的 差别 来 了 。Webpack 的 重点 完全 放 在 构建 打包 文 
件 上 ， 所 以 生成 带 有 CommonJS 热 片 的 打包 文件 也 在 它 的 能 力 范 围 之 内 。 打 开 dist/bundle.js， 应 
该 可 以 看 到 文件 顶部 的 webpackBootstrap 热 片 ， 然 后 从 源 文件 结构 中 过 来 的 每 个 文件 都 被 封 




















[a 
A 
了 
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装 在 了 闭 包 内 模拟 模块 系统 中 。 下 面 是 从 打包 文件 中 截取 的 代码 : 


function(module, exports, _ webpack_ require ) { 
const hello = _ webpack_ require (1); 
hello(); 
Me A 
pa 外 人 


/***/ function(module, exports) { 


module.exports = function() { 
return 'hello'; 

j 
代码 中 的 注释 表明 了 模块 是 在 哪里 定义 的 , 这 些 文档 将 modaule 和 exports 对 象 作为 参数 ， 
可 以 访问 它们 的 闭 包 来 模拟 CommonJS 模块 API。 

2. 在 Webpack 中 使 用 npm 包 

我 们 还 可 以 更 进一步 ， 引 入 从 npm 上 下 载 下 来 的 包 。 比 如 说 你 想 用 jQuery。 除 了 在 页 面 里 
用 script 标签 指向 它 ， 还 有 男 一 种 办 法 。 用 npm i --save-dev jquery 安装 它 ， 然 后 像 加 
载 Node 模块 那样 加 载 它 : 

const jquery = require('jquery'); 

也 就 是 说 Webpack 把 CommonJS 模块 给 了 我 们 , 无 须 任 何人 额外 的 配置 , 就 可 以 使 用 来 自 npm 
的 模块 。 












































寻找 加 载 器 和 插件 
Webpack 网 站 上 有 加 载 器 和 插件 列表 。 npm 上 也 有 Webpack 工具 , 可 以 从 关键 字 webpack 
开始 。 


4.5 总 结 


D npm 脚本 是 实现 简单 任务 自动 化 和 脚本 调用 的 最 佳 选择 。 

口 Gulp 可 以 用 JavaScript 编写 更 加 复杂 的 任务 ， 并 且 它 是 跨 平台 的 。 

口 如 果 gulpfiles 变 得 太 长 了 ， 可 以 把 代码 分 解 到 多 个 文件 中 。 

口 Webpack 可 以 用 来 生成 客户 端 打 包 文 件 。 

口 如 果 只 需要 构建 客户 端 打包 文件 ， 用 Webpack 可 能 比 用 Gulp 更 省 事 儿 。 
口 Webpack 支持 热 重 载 ， 也 就 是 说 刷新 浏览 器 就 能 看 出 代码 的 变化 。 




















本 章 内 容 

口 使 用 热门 的 Node Web 框架 
口 选择 合适 的 框架 

口 用 Web 框架 搭建 Web 程序 




















本 章 介 绍 服务 器 端 Web 框架 。 要 回答 的 问题 是 :如何 为 给 定 项 目 选 择 最 好 的 框架 ， 每 个 框 
架 的 优 缺 点 是 什么 。 

选择 正确 的 框架 很 难 ， 因 为 很 难 在 一 个 公平 的 环境 里 进行 比较 。 大 多 数 人 都 没 时 间 把 所 有 框 
架 了 解 清楚 ,所 以 我 们 一 般 会 草率 地 决定 就 用 之 前 用 过 的 。 有 时 可 能 要 同时 用 不 同 的 框架 。 比 如 
在 一 个 大 型 程序 中 ， 先 用 了 Express， 为 了 支持 微服 务 ， 又 引入 了 hapi。 
比如 说 ， 你 要 给 一 家 研究 机 构 搭建 一 个 内 容 管 理 系统 , 用 来 管理 他 们 收集 的 法 律 文件 。 这 个 
系统 要 能 输出 PDF， 有 电子 商务 组 件 。 这 样 的 系统 可 能 会 用 到 下 面 几 个 框架 : 
口 文件 上 传 、 下 载 、 阅 读 
口 生成 PDF 的 微服 务 
口 电子 商务 组 件 一 一 Sails.js。 

选用 最 合适 的 框架 , 既 要 看 项 目 需 要 什么 , 也 要 看 开发 项 目的 团队 。 本 章 会 用 用 户 画 像 法 ( 假 
想 的 人 物 ) 来 讨论 各 个 框架 适合 哪 类 项 目 。 通 过 这 些 假想 中 的 程序 员 ， 你 会 接触 到 Koa、hapi、 
Sailjs、DerbyJS 、Flatiron 和 LoopBack。 下 面 先 来 定义 这 些 用 户 。 


5.1 用 户 画 像 


我 们 不 想 让 你 在 每 个 项 目 上 都 用 同一 个 框架 。 能 够 做 到 兼 收 并 蓄 、 针 对 每 个 问题 组 合 使 用 合 
适 的 工具 则 更 好 。 用 用 户 画 像 考虑 设计 问题 是 通用 做 法 ,因为 这 在 某 种 程度 上 能 让 设计 师 跟 用 户 
产生 共鸣 。 

为 了 让 你 从 第 三 人 视角 考虑 这 些 框架 , 明白 如 何 为 不 同类 型 的 项 目 找到 不 同 的 解决 方案 , 本 
章 就 用 了 用 户 画 像 法 。 这些 用 户 是 用 专业 情况 和 开发 工具 来 定义 的 。 你 至 少 应 该 能 认 出 下 面 定义 
的 三 种 用 户 中 的 一 种 。 









































Express; 





hapi; 
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5.1.1 菲 尔 : 代理 开发 者 


菲 尔 已 经 做 了 三 年 的 全 栈 开 发 了 。 他 写 过 Ruby、Python 和 客户 端 JavaScript。 
口 职业 情况 一 一 雇员 ， 全 栈 开 发 。 
D 工作 类 型 一 一 前 端 工程 、 后 台 开 发 。 
口 电脑 MacBook Pro。 
口 工具 Sublime Text、Dash、xScope、Pixelmator、Sketch、GitHub。 
口 教育 背景 高 中 毕业 ， 从 业余 爱好 者 开始 ， 最 终 变 成 了 职业 程序 员 。 
菲 尔 通常 是 跟 设 计 师 和 用 户 体验 专家 一 起 , 用 敏捷 的 方式 开发 或 评审 新 功能 , 同时 也 要 承担 
维护 和 错误 修订 工作 。 


5.1.2 ” 纳 迪 娜 : 开源 开发 者 


纳 迪 娜 之 前 是 一 名 企业 Web 开发 人 员 ， 做 得 挺 成 功 ， 后 来 开始 自己 接 活 了 。 
口 职业 情况 一 一 自由 职业 ，JavaScript 专家 。 
口 工作 类 型 一 一 后 台 开 发 , 偶尔 用 Go 和 Erlang 做 高 性 能 程序 。 还 写 了 一 个 开源 的 电影 目录 
Web 程序 。 
D 电脑 一 一 高 端 PC，Linux。 
口 工具 Vim、tmux、Mercurial 以 及 shell 里 的 所 有 工具 。 
口 教育 背景 一 一 计算 机 科学 专业 毕业 。 
纳 迪 娜 每 天 都 要 给 她 的 两 个 主要 客户 和 自己 的 开源 项 目 协调 出 足够 的 时 间 。 她 给 客户 做 的 
项 目 是 测试 驱动 的 ,但 她 的 开源 项 目 更 偏向 于 功能 驱动 。 


5.1.3 ”爱丽 丝 : 产品 开发 者 


爱丽 丝 在 做 一 个 成 功 的 iOS app， 也 在 帮忙 做 公司 的 Web API。 
口 职业 情况 一 一 雇员 ， 程 序 员 。 






























































































































































口 工作 类 型 一 iOS 开发 ， 同 时 负责 Web 程序 和 Web 服务 。 
口 电脑 MacBook Pro, iPad Pro。 








口 工具 Xcode、Atom、Babel、Perforce。 
口 教育 背景 一 一 理科 毕业 ， 现 在 任职 的 这 家 创业 公司 的 前 五 名 员工 之 一 。 

爱丽 丝 用 Xcode 写 Objective-C 和 Swift， 但 有 些 勉强 ， 其 实 她 更 喜欢 JavaScript，ES2015 和 
Babel 让 她 觉得 很 兴奋 ! 开发 新 的 Web 服务 支持 公司 的 iOS 和 桌面 程序 对 她 来 说 只 是 开胃 小 菜 ， 
爱丽 丝 希 望 能 经 常 做 基于 React 的 Web 程序 。 

用 户 定 义 好 了 ， 接 下 来 定义 术语 框架 。 
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5.2 ” 框 洪 是 什么 


从 技术 角度 来 看 , 本章 介 绍 的 一 些 服务 器 端 框 架 根 本 不 是 框架 。 关 于 框架 这 个 词 ,， 不同 的 程 
序 员 对 它 有 不 同 的 理解 。 在 Node 社 区 ， 这 些 项 目 大 部 分 都 应 该 叫 模块 ， 但 更 细微 的 定义 有 助 于 
我 们 对 这 一 族 的 库 进 行 比较 。 

LoopBack 项 目 用 了 如 下 定义 。 

口 API 框 架 一 一 用 于 搭建 Web API 的 库 ， 有 协助 组 织 程序 结构 的 框架 支持 。LoopBack 将 自 

己 定义 为 这 类 框架 。 

口 HTTP 服务 器 库 一 一 所 有 基于 Express 的 项 目 都 可 以 归 为 这 一 类 ， 包括 Koa 和 Kraken.js。 
这 些 库 帮 我 们 围绕 HTTP 动词 和 路 由 搭建 程序 。 

D HTTP 服务 器 框架 一 一 用 来 搭建 模块 化 HITP 服务 器 的 框架 。hapi 就 是 这 种 框架 

D Web MVC 框架 一 一 模型 -视图 -控制 器 框架 ，Sailjs 就 是 这 种 框架 。 

口 全 栈 框架 一 一 这 些 框架 在 服务 器 端 和 浏览 器 上 用 的 都 是 JavaScript， 并 且 两 端 可 以 共享 代 
码 。 这 被 称 为 同 构 代 码 。DerbyJS 是 个 全 栈 MVC 框架 。 

大 多 数 Node 开发 人 员 都 把 框架 理解 为 第 二 种 : HTTP 服务 器 库 。 下 一 节 介 绍 的 Koa 就 是 一 
个 服务 器 库 ， 它 独辟蹊径 ， 用 ES2015 语法 中 新 创 的 生成 器 来 定义 HTTP 中 间 件 。 


5.3 Koa 


Koa 是 以 Express 为 基础 开发 的 , 但 它 用 ES2015 中 的 生成 器 语法 来 定义 中 间 件 。 也 就 是 说 我 
们 几乎 可 以 编写 异步 的 中 间 件 。 这 在 某 种 程度 上 解决 了 中 间 件 重度 依赖 回调 的 问题 。 在 Koa 中 可 
以 用 yiela 退出 和 重 人 中 间 件 。 表 5-1 是 Koa 的 主要 特点 。 
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表 5-1 Koa 的 主要 特点 
库 类 型 HTTP 服务 器 库 
功能 特性 基于 生成 器 的 中 间 件 ， 请 求 /响应 模型 
建议 应 用 轻型 Web 程序 、 不 严格 的 HTTP API、 单 页 Web 程序 
插件 架构 中 间 件 
文档 http://koajs.com/ 
热门 程度 GitHub 10 000 颗 星 
授权 许可 MIT 














下 面 这 段 代码 演示 了 在 Koa 中 如 何 用 yiela 转 到 下 一 个 中 间 件 组 件 ， 等 它 执行 完 后 再 回来 
继续 执行 调用 者 中 间 件 的 逻辑 。 


代码 清单 5-1 ”Koa 的 中 间 件 顺序 














const koa = require('koa'); 
Const app-= Koat(}y 
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app.use (function* (next) { ee 
const start = new Date; yield 以 运行 下 在 中 间 件 函 
yield next; 一 个 中 间 件 组 件 数 上 使 用 生 
const ms = new Date - start; 成 器 语法 
console.log('%s %s - %$s', this.method, this.url, ms); 症 吉 / 
有 
app.use (function*() { 4 
oy es: HELlLe WOrFLd 回 到 当初 yield 的 


}); 位 置 继 续 执行 


app.listen(3000); 

代码 清单 5-1 用 生成 右 @ 在 两 个 中 间 件 的 上 下 文中 切换 。 注 意 关 键 字 function *， 这 里 是 
不 可 能 用 箭头 函数 的 。 用 yiela 关键 字 @ 将 执行 步骤 转 到 中 间 件 的 栈 中 去 ， 然 后 在 下 一 个 中 间 
件 返 回 后 再 回来 全 @。 使 用 生成 器 函数 带 来 的 额外 好 处 是 只 要 设 定 this .body 就 好 了 。Express 
则 需要 用 函数 来 发 送 响 应 : res .send (response)。 在 Koa 中 间 件 中 ,this 就 是 上 下 文 。 每 个 
请 求 都 有 对 应 的 上 下 文 , 用 来 封装 Node 的 HTTP regquest 和 response 对 象 。 在 需要 访问 请 求 
里 的 东西 时 ， 比 如 GET 参数 或 cookie， 可 以 通过 这 个 请 求 上 下 文 来 访问 。 响 应 也 是 如 此 ， 就 像 
代码 清单 5-1 里 所 展示 的 ， 设 定 this .body 里 的 值 就 可 以 控制 送 什么 给 浏览 

如 果 你 之 前 用 过 Express 中 间 件 和 生成 天 语法 ， 学 会 Koa 应 该 并 不 难 。 和 否则 可 能 不 太 容 易 搞 
懂 , 至 少 不 明 白 Koa 这 种 方式 有 什么 好 处 。 关 于 yield 是 如 何在 中 间 件 组 件 间 进行 切换 的 , 图 5-1 
给 出 了 更 多 细 市 。 

5-1 中 的 每 个 阶段 都 是 跟 代 码 清 单 5-1 中 的 数字 对 应 的 。 首 先 ， 在 第 一 个 中 间 件 组 件 里 创 
建 计时 带 @， 人 然后 执行 跳 转 到 第 二 个 中 间 件 组 件 里 去 泻 染 body@。 在 响应 发 送出 去 后 ， 回 到 第 
一 个 中 间 件 组 件 继 续 执 行 , 计算 出 时 间 全 。 用 console.1og 在 终端 里 输出 , 请 求 完成 @, 注意 ， 
阶段 @ 在 代码 清单 5-1 中 看 不 出 来 ， 它 是 由 Koa 和 Node 的 HTTP 服务 器 处 理 的 。 




























































































人 @ 在 第 一 个 中 辐 @ 所 行 晃 转 到 第 二 个 
WE 出 和 种: 肯 淮 中 间 件 组 件 中 间 件 ， 泻 染 视 图 












一 二 -| 创建 计时 器 
跳 转 


计算 总 耗 时 














泻 染 body 


发 送 响 应 



























































| O@ en 
a 响应 完成 后 ， 执 
@@ 在 日 志 中 显示 总 耗 时 行 跳 转 回 第 一 个 
中 间 件 组 人 

















图 5-1 Koa 中 间 件 的 执行 顺序 





5.3.1 设置 

Koa 项 目的 设置 工作 包括 安装 模块 和 定义 中 间 件 。 如 果 需 要 更 多 功能 ， 比 如 要 通过 路 由 API 
定义 和 响应 各 种 HTTP 请 求 , 则 需要 安装 路 由 中 间 件 。 也 就 是 说 典型 的 工作 流程 需要 事先 规划 好 
项 目 要 用 到 的 中 间 件 ， 所 以 我 们 先 要 研究 一 下 有 哪些 流行 的 模块 。 
























































点 评 
爱丽 丝 :“ 作 为 产品 开发 人 员 ， 我 喜欢 Koa 的 最 小 功能 集 ， 因 为 我 们 的 项 目 需求 独特 ,我 
们 非常 起 根据 需求 来 框 定 整个 技术 栈 。 , 
菲 尔 :“ 作 为 代理 开发 人 员 ， 我 发 现 中 间 件 搜索 阶段 的 处 理 太 麻 烦 了 。 我 希望 框架 能 帮 有 我 
处 理 好 , 并 且 因 为 我 经 手 的 很 多 项 目 需求 都 差不多 , 所 以 不 想 总 是 安装 相同 的 模块 来 做 这 些 基 
础 性 工作 。” 


了 三方 模 块 ， 它 为 Koa 提供 了 一 个 强大 的 路 由 库 。 


下 一 方 会 介绍 一 个 第 





5.3.2 ”定义 路 由 
koa-router 是 一 个 流行 的 路 由 需 中 间 件 组 件 。 它 也 是 基于 HTTP 动词 的 ， 
不 同 之 处 是 它 的 链 式 API。 下 面 这 段 代码 演示 了 它 的 路 由 定义 : 











这 点 跟 Express 一样， 





























router 

:Doest( /Dages' 7 
// 创建 页 面 

} 

.get ('/pages/:id', 
// 演 米 页 面 

} 

.put ('pages-update', 
// 更 新 页 面 


3 
可 以 提供 额外 的 参数 给 路 由 命名 。 这 可 以 用 来 生成 URL, 并 不 是 所 有 Node Webt 
这 一 功能 。 这 里 有 个 例子 : 
router.url('pages-update' 


这 个 模块 融合 了 Express i Web 框架 的 功能 。 


function* (next) { 


function* (next) { 


'/pages/:id', function* (next) { 





E 架 都 支持 




















'99'); 





点 评 
菲 尔 :“ 这 个 路 由 库 让 我 想起 了 RoR 上 的 一 些 功 能 ， 我 喜欢 它 ， 所 以 Koa 能 赢得 我 的 
纳 迪 娜 :“ 我 发 现 可 以 用 Koa 对 我 已 有 的 项 目 做 些 模块 化 处 理 ， 并 跟 社 区 分 享 这 些 


代码 。” 


5.4 Kraken 77 





5.3.3 REST API 


Koa 没有 提供 实现 RESTful API 所 必需 的 工具 ， 只 能 借助 某 种 路 由 处 理 中 间 件 。 前 面 那 个 例 
子 可 以 扩展 一 下 ， 在 Koa 中 实现 RESTful API。 


5.3.4 优点 


以 前 可 以 说 Koa 在 采用 生成 器 语法 上 有 先 发 优 势 ， 但 随 着 ES2015 在 Node 社区 中 的 普及 ， 
这 已 经 算 不 上 是 Koa 的 优势 了 。Koa 现在 的 主要 优势 是 它 很 精简 ， 还 有 一 些 非常 棒 的 第 三 方 模块 ， 
Koa 的 维基 百科 上 有 更 详细 的 介绍 。 因 为 语法 优雅 ， 能 根据 项 目的 具体 需求 量 身 定制 ， 所 以 Koa 
深 受 开发 人 员 喜 爱 。 









































5.3.5 “弱点 


Koa 的 可 配置 水 平 让 一 些 开发 人 员 望 而 却步 。 除非 有 现成 的 代码 共享 策略 ,否则 用 Koa 创建 
太 多 小 项 目 会 导致 低下 的 代码 复 用 率 。 








5.4 Kraken 


Kraken 是 基于 Express 的 ， 又 通过 Paypal 开发 的 一 些 定制 模块 添 了 些 新 功能 。 为 程序 提供 安 
全 层 的 Lusca 是 其 中 特别 实用 的 一 个 模块 。 虽 然 Lusca 可 以 独立 于 Kraken 使 用 , 但 Kraken 还 有 
一 个 好 处 是 它 预定 义 的 项 目 结构 。Express 和 Koa 程序 对 项 目 结构 没有 任何 要 求 ， 相 较 之 下 ， 
Kraken 在 创建 新 项 目 上 提供 了 更 多 帮助 。 表 5-2 中 是 Kraken 的 主要 特性 。 


表 5-2 Kraken 的 主要 特性 












































库 类 型 HTTP 服务 器 库 
功能 特性 对 象 项 目 结构 要 求 严 格 、 模 型 、 模 板 (Dust )、 安 全 强化 ( Lusca )、 配 置 管理 、 国 际 化 
建议 应 用 企业 Web 程序 
插件 架构 Express 中 间 件 
文档 https:/www.kraken.com/help/api 
热门 程度 GitHub 4000 颗 星 
授权 许可 Apache 2.0 
5.4.1 设置 
可 以 将 Kraken 作为 中 间 件 组 件 添加 到 Express 项 目 中 : 
const express = require('express'), 


const kraken = require('kraken-js'); 
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const app = express (); 

app.use (kraken ()); 

app.listen(3000); 

也 可 以 用 Kraken 的 Yeoman 生成 高 创建 一 个 新 项 目 。Yeoman 是 用 来 生成 新 项 目的 工具 ， 我 
们 可 以 用 它 的 生成 器 生成 各 种 框架 的 初始 项 目 。 下 面 是 用 Yeoman 创建 Kraken 项 目 所 需 的 步骤 ， 
这 里 使 用 了 Kraken 偏好 的 文件 系统 结构 : 














$ npm install -g yo generator-kraken bower grunt-cli 
$ yo kraken 


(@) (@ 


9 ，: 世 
| Release the Krakenl 
) 


\ 
| 
( 
人 


Tell me a bit about your application: 


[?] Name: kraken-test 
[?] Description: A Kraken application 
[?] Author: Alex R. Young 





生成 器 会 创建 新 的 目录 , 不 用 我 们 自己 动手 。 在 生成 器 完成 了 自己 的 工作 后 , 你 可 以 启动 服 
务 器 ， 然 后 访问 http://localhost:8000 看 看 它 生成 了 什么 。 





5.4.2 定义 路 由 


在 Kraken 中 , 路 由 被 定义 为 跟 控 制 器 在 一 起 。 这 跟 Express 把 路 由 定义 和 路 由 处 理 融 分 开 的 
做 法 不 同 ，Kraken 采用 了 MVC 的 方式 ， 由 于 ES6 箭头 函数 的 使 用 ， 这 样 更 轻便 : 


module.exports = (router) = 
router.get('/', (reqg, res 
res.render('index'); 
} 了 3 
} 


路 由 器 可 以 在 URL 中 放置 参数 : 








> 
) => { 





module.exports = (router) => { 
router.get('/people/:id', (reqgq, res) => { 
const people = { alex: { name: 'Alex' } }; 


res.render('people/edit', people[lregq.param.id]); 
这 
3 


Kraken 的 路 由 API 是 express-enrouten， 并 且 它 会 根据 文件 所 在 的 目录 推断 路 由 。 比 如 说 ， 
如 果 有 下 面 这 样 的 目录 结构 : 














5.5 hapi 79 





controllers 
|-user 
|-create.js 
|-list.js 


那么 Kraken 会 生成 路 由 /user/create 和 /user/list。 


5.4.3 REST API 


Kraken 可 以 做 REST API， 但 没有 什么 特别 的 支持 。express-enrouten 可 以 跟 解 析 JSON 的 中 
间 件 相 结 合 ， 所 以 能 实现 REST API。 

Kraken 的 路 由 器 支持 DELETE .GET .POST .PUT 等 HTTP 动词 , 在 实现 REST 时 跟 Express 
类 似 。 


5.4.4 优点 


由 于 生成 器 的 原因 ，Kraken 项 目 从 大 体 上 来 看 都 差不多 。 虽 然 Express 项 目的 目录 结构 可 以 
随心 所 欲 ， 但 Kraken 项 目 一 般 不 会 改变 文件 和 目录 的 位 置 。 

因为 模板 库 (Dust ) 和 国际 化 库 (Makara ) 都 是 Kraken 自 带 的 ， 所 以 它们 两 个 可 以 无 颖 集 
成 。 在 编写 支持 国际 化 的 Dust 模板 时 ， 需 要 指定 键 : 

<hl>{@pre type="content" Key="greeting"/}</n1L> 

还 要 添加 名 称 符合 locales/language-code/view-name.properties 模式 的 属性 文件 。 这 些 属性 文 
件 中 只 是 简单 的 键 / 值 对 ， 比 如 说 ， 如 果 之 前 那个 例子 中 的 视图 文件 是 public/templates/profile.dust， 
那么 对 应 的 属性 文件 应 该 是 locales/US/en/profile.properties。 









































点 评 
菲 尔 :“Kraken 的 文件 结构 和 用 控制 器 处 理 路 由 这 两 点 非常 对 我 的 胃口 。 我 们 团队 里 有 人 
会 Django 和 RoR，, 让 他 们 换 成 Kraken 应 该 不 会 太 难 。Kraken 的 文档 看 起 来 也 很 棒 , 博客 上 有 
民 多 干货 。 
爱丽 丝 :“ 我 喜欢 用 Lusca 增加 程序 安全 性 这 个 想法 ， 但 Kraken 中 也 有 我 不 需要 的 东西 。 
我 准备 抛 开 Kraken， 单 独 试 试 Lusca。” 


~ 


5.4.5 ”弱点 


Kraken 比 Koa 或 Express 难 学 。 一些 在 Express 中 可 以 通过 编程 完成 的 任务 ,在 Kraken 中 要 
通过 JSON 配置 文件 来 做 ， 并 且 有 了 时候 很 难 确定 到 底 要 用 哪些 JSON 属性 才能 得 到 预期 结果 。 





























5.5 hapi 


hapi 是 个 服务 需 框 架 ， 它 的 重点 是 Web API 的 开发 。hapi 有 自己 的 插件 API， 完 全 没有 客户 
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端 支持 ， 也 没有 数据 模型 屋 。hapi 有 路 由 API 和 它 自己 的 HTTP 服务 器 封装 。 在 hapi 中 设计 APL， 
要 把 服务 器 当 作 主 抽象 。 从 DevOps 的 观点 来 看 ，hapi 自 带 的 连接 和 日 志 功 能 使 得 它 易 于 扩展 和 
管理 。 表 5-3 中 是 hapi 的 主要 特性 。 








表 5-3 hapi 的 主要 特性 
































库 类 型 HTTP 服务 器 库 
功能 特性 高 层 服务 器 容器 抽象 ， 安 全 的 头 部 信息 
建议 应 用 单 页 Web 程序 、HTTPAPI 
插件 架构 hapi 插件 
文档 http://hapijs.com/api 
热门 程度 GitHub 6000 颗 星 
授权 许可 BSD 3 条 款 
5.5.1 设置 


首先 创建 一 个 新 的 Node 项目， 安装 hapi: 


mkdir listing5_2 

[ele eb ote 2 

npm init -y 

npm install --save hapi 


然后 创建 文件 serverjs， 将 下 面 的 代码 加 入 其 中 。 
代码 清单 5-2 基本 的 hapi 服务 顺 


const Hapi = require('hapi'); 
const server = new Hapi.Server(); 





SerVer .connection({ 
host: 'localhost', 

port: 8000 

j 


server.start ((err) => { 
if (err) { 
throw err; 
console.log('Server running at:', server.info.uri); 


下 过 


这 样 已 经 可 以 运行 了 ， 但 如 果 没 有 路 由 ， 它 也 做 不 了 什么 。 接 下 来 我 们 讲 hapi 怎么 处 理 
路 由 。 























5.5.2 ”定义 路 由 
hapi 有 创建 路 由 的 API。 要 创建 路 由 ， 必 须 提供 一 个 包含 请 求 方法 、URL 和 回调 函数 的 对 象 ， 
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其 中 的 回调 函数 就 是 路 由 处 理 器 。 下 面 是 带 处 理 器 方法 的 路 由 定义 示例 。 


代码 清单 5-3 hapi 的 入 门 服务 器 
const Hapi = require('hapi'); 
Const server = new Hapi.Server(); 


server.connection({ 
host: 'localhost', 

port: 8000 

a 


server.routel{ 


method: 'GET', 
path:'/hello', 
handler: (request, reply) => { 


return reply('hello world'); 
} 
和 
server.start((err) => { 
if (err) { 
throw err; 
} 
console.log('Server running at:', 


}); 


server.info 


中 。 执 行 npm start 命令 运行 这 个 服务 器 ， 然 后 打开 ht 


这 段 代码 定义 了 一 个 路 由 ， 以 及 将 文本 hello world 作为 了 


ba 和 本: 


向 应 的 处 理 絮 。 把 它 添加 到 serverjs 
tp://localhost:8000/hello 看 看 响应 结 




















hapi 没有 预定 义 的 目录 结构 或 任何 MVC 特性 ， 它 完全 是 基于 服务 器 的 。 从 这 点 来 看 ，hapi 








跟 Express 很 像 。 然 而 hapi 的 request 和 reply 路 由 处 至 

hapi 的 请 求 和 响应 对 象 也 不 同 于 Express 中 的 对 等 对 象 : 

的 res 对 象 。Express 更 像 Node 自 带 的 HTTP 服务 需 。 
更 加 复杂 的 功能 ， 


5.5.3 插件 














天 签名 跟 Express 的 req 和 res 不 同 。 
必须 调用 reply， 而 不 是 操作 Express 

















比如 提供 静态 文件 ， 需 要 靠 插 件 来 完成 。 





hapi 有 自己 的 插件 架构 ， 并 且 大 部 分 项 目 都 需要 靠 插 件 完成 认证 和 输入 校 验 等 功能 。inert 
是 大 多 数 项 目 都 需要 的 简单 插件 ， 它 提供 了 静态 文件 和 目录 处 理 器 。 














要 将 inert 添加 到 hapi 项 目 中 ， 需 要 先 用 server.r 


gister 方法 注册 这 个 插件 。 由 此 添加 


发 送 单个 文件 的 reply .file 方法 和 一 个 目录 处 理 器 。 下 面 来 看 一 下 目录 处 理 器 。 
首先 确保 你 已 经 创建 了 基于 代码 清单 5-2 的 项 目 。 然 后 ， 安 装 inert: 


npm install --save inert 


现在 可 以 加 载 和 注册 插件 了 。 打 开 serverjs， 添 加 下 


面 的 代码 。 
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代码 清单 5-4 ”用 hapi 添 加 插件 


const Inert = require('inert'); 
server.register(Inert, () => {}); 


server.routel(l{ 
method: 'GET', 
ath "(Daram*y} 
handler: { 
directory: { 
Da 
redirectToSlash: true, 
index: true 
} 
} 
J 


除了 函数 ，hapi 路 由 还 可 以 接受 插件 的 配置 对 象 。 在 这 段 代 码 中 ，directory 对 象 中 就 是 
inert 的 配置 参数 ， 其 含义 是 提供 当前 目录 中 的 静态 文件 ， 并 显示 该 目录 下 文件 的 索引 。 这 跟 
Express 的 中 间 件 不 同 。 从 这 个 例子 可 以 看 出 , 在 hapi 程 序 中 , 搬 件 是 如 何 扩展 服务 器 的 行为 的 。 















































5.5.4 RESTAPI 


hapi 支持 HTTP 动词 和 URL 参数 化 ,允许 用 标准 的 hapi 路 由 API 实现 REST API。 下 面 这 段 
代码 是 一 个 普通 的 删除 方法 的 路 由 : 


server.routel(l{ 
method: 'DELETE', 
path: '/items/{id}', 
handler: (req, reply) => { 
// 基于 req.params .id 删除 “item” 
reply (true); 
3} 
站 小 汉 


另外 ， 有 些 插件 让 创建 RESTful API 变 得 容易 了 。 比 如 说 ，hapi-sequelize-crud 可 以 基于 
Sequelize 模型 自动 生成 RESTful API。 


























点 评 

菲 尔 :“ 我 一 定 要 试 试 hapi-sequelize-crud， 因 为 我 们 已 经 有 程序 在 用 PostgreSQL 和 
MySQL 了 ， 所 以 Sequelize 应 该 会 合适 。 但 hapi 自己 没有 提供 这 样 的 功能 ， 如 果 将 来 这 个 插 
件 没 人 支持 就 麻烦 了 ， 所 以 我 不 太 确定 hapi 是否 适合 代理 场景 。” 

爱丽 丝 :“ 作 为 产品 开发 人 员 ， 我 对 hapi 很 感 兴趣 ， 因 为 它 像 Express 一 样 ， 坚 持 走 极 简 
路 线 ， 另 外 插件 API 也 更 加 正式 ， 富 有 表现 力 。 

纳 迪 娜 :“ 我 觉得 可 以 给 hapi 做 几 个 开源 插件 ， 并 且 现 有 插件 写 得 都 不 错 。 看 起 来 hapi 
的 受众 在 技术 上 没 问题 ， 这 也 是 它 能 吸引 我 的 原因 之 一 。” 


3.6 Sails.js 
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5.5.5 “优点 




















hapi 的 插件 API 是 它 最 大 的 优势 。 插 件 不 仅 能 扩展 hapi 的 服务 需 , 还 可 以 添加 各 种 各 样 的 功 
能 ， 比 如 数据 校 验 和 模板 等 。 另 外 , 由 于 hapi 是 基于 HTTP 服务 器 的 ,所 以 适合 用 在 某 些 部 署 场 
景 中 。 如 果 要 部 署 很 多 相互 连接 的 服务 器 ， 或 者 需要 做 负载 均衡 时 ，hapi 基于 服务 侣 的 API 可 能 











比 Express 或 Koa 好 用 。 


5.5.6 ”弱点 


hapi 的 弱点 跟 Express 一 样 : 





5.6 Sails.js 


























极 简 ， 所 以 对 项 目 结构 没有 把 控 。 我 们 永远 也 不 知道 哪个 插件 
的 开发 会 停 下 来 ， 所 以 过 于 依赖 插件 可 能 会 造成 将 来 难以 维护 。 

















我 们 之 前 介绍 的 都 是 极 简 的 服务 器 库 。 接 下 来 要 讲 的 Sails 跟 它 们 有 本 质 上 的 区 别 ， 这 是 一 














个 模型 -视图 -控制 絮 框 架 。Sails 有 一 个 跟 数据 库 协同 作用 的 对 象 关系 映射 (ORM ) 库 ， 








还 能 自 


动 生 成 REST API。 它 支持 WebSocket 等 现代 化 的 功能 。 如 果 你 喜欢 用 React 或 Angular， 应 该 会 

















很 高 兴 它 是 前 端 无 关 的 : Sails 不 是 全 栈 框 


Sails 的 主要 特性 。 





库 类 型 
功能 特性 
建议 应 用 
插件 架构 
文档 
热门 程度 
授权 许可 


























菲 
爱 
然 它 主要 


5.6.1 设置 


Sails 有 项 目 生 成 器 ， 所 以 最 好 是 全 局 安装 ， 这 样 创建 新 项 目 会 更 轻松 。 用 npm 安装 


用 sails nevw 创建 项 目 : 

















表 5-4 Sails 的 主要 特性 
MVC 框架 
有 支持 数据 库 的 ORM， 生 成 REST API，WebSocket 
Rails 风格 的 MVC 程序 
Express 中 间 件 


http://sailsjs.org/documentation/concepts 














GitHub 6000 颗 星 


BSD 3 条 款 


点 评 


尔 :“ 听 起 来 就 是 我 想 要 的 ， 它 的 缺点 是 什么 ? ” 
丽 丝 :“ 我 觉得 这 可 能 不 适合 我 ， 因 为 我 们 已 经 把 时 间 用 在 开发 React 程序 上 了 ， 但 既 
要 是 用 来 做 服务 器 的 ， 可 能 会 适合 我 们 的 产品 。” 








架 , 所 以 可 以 跟 任 何 前 端 库 或 框架 配合 使 用 。 表 5-4 是 

















， 然 后 
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npm install -9 sails 
sails new example-project 


之 后 会 出 现 一 个 新 创建 的 目录 , 其 中 有 package.json 和 基本 的 Sails 依赖 项 。 这 个 新 项 目 包 含 
了 Sails 本 身 、EJS 和 Grunt。 运 行 npm start 或 sails 1ift 都 可 以 启动 服务 器 。 服 务 器 跑 起 
来 后 ， 访 问 http://localhost:1337 可 以 看 到 自 带 的 初始 页 。 








5.6.2 定义 路 由 


Sails 中 将 路 由 称 为 定制 路 由 ， 打 开 config/routes.js， 在 输出 的 路 由 中 添加 新 的 属性 即 可 添加 
路 由 。 属 性 的 格式 是 HTTP 动词 加 上 部 分 URL。 比 如 像 下 面 这 样 : 


























module.exports.routes = { 
'get /example': { view: 'example’' }, 
'post /items': 'ItemController.create 


js 
第 一 个 路 由 需要 文件 view/example.ejs。 第 二 个 路 由 需要 有 create 方法 的 api/controllers/ 
ItemController。 运 行 命 令 sails generate controller item create 可 以 生成 带 有 create 


方法 的 控制 器 。 也 可 以 用 类 似 的 命令 生成 RESTful API。 











5.6.3 RESTAPI 


Sails 将 数据 库 模 型 和 控制 器 结合 进 了 API 中， 可 以 用 命令 sails generate api resource- 
name 生成 RESTful API。 要 使 用 数据 库 ， 首 先 需 要 安装 数据 库 适 配器 。 找 到 Waterline MySQL 包 
的 名 字 ， 然 后 把 它 添 加 到 项 目 中 

npm install --save waterline sails-mysal 

接 下 来 ， 打开 config/connectionsjs， 将 MySQL 服务 器 的 连接 信息 填 好 。Sails 模型 文件 中 可 
以 指定 数据 库 连 接 , 所 以 不 同 的 模型 可 以 使 用 不 同 的 数据 库 。 也 就 是 说 可 以 把 用 户 会 话 数据 放 在 
Redis 之 类 的 数据 库 中 ， 而 把 需要 持久 保存 的 数据 放 到 MySQL 这 样 的 关系 型 数据 库 中 。 

Waterline 是 Sails 的 数据 库 系 统 库 ， 除 了 支持 多 个 数据 库 ， 它 还 能 定义 表 和 列 名 ， 以 支持 遗 
留 的 数据 库 模 式 。 男 外 ， 它 的 查询 API 支持 promise， 因 此 查询 看 起 来 很 像 现代 化 的 JavaScript。 
































菲 尔 :“ 听 起 来 非常 适合 我 们 ， 首 先是 可 以 轻松 创建 API， 其 次 是 Waterline 模型 能 支持 已 
有 的 数据 库 模 式 。 我 们 想 把 一 些 客户 缓慢 地 从 MySQL 迁移 到 PostgreSQL，Waterline 能 满足 这 
个 要 求 。 我 们 的 一 些 开 发 人 员 和 设计 师 用 过 RoR， 所 以 我 觉得 他 们 马上 就 能 掌握 Sails。” 

爱丽 丝 :“ 这 个 框架 里 有 我 们 的 产品 不 需要 的 东西 。 我 觉得 Koa 或 hapi 可 能 更 合适 。” 
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5.6.4 优点 


自 带 的 项 目 创建 和 API 生成 意味 着 可 以 快速 设置 项 目 ， 快 速 添加 典型 的 REST API。 因 为 
Sails 项 目的 文件 系统 结构 都 是 一 样 的 ， 所 以 也 有 利于 创建 新 项 目 和 相互 协作 。Sails 的 创建 者 
Mike McNeil 和 Irl Nathan 共同 写 了 本 书 ， 叫 Sails in 4ction， 书 中 曾 述 了 Sails 对 Node 新 手 是 多 么 
友好 。 

















5.6.5 ”弱点 

Sails 的 弱点 跟 其 他 服务 器 端 MVC 框架 一 样 : 路 由 API 意味 着 我 们 在 设计 程序 时 必须 考虑 到 
Sails 的 路 由 特性 ， 并 且 由 于 Waterline 的 处 理 方 式 ， 可 能 很 难 将 数据 库 模 式 调整 为 符合 它 的 要 求 
的 样子 。 








5.7 DerbyJS 


DerbyJS 是 全 栈 框架 ， 支 持 数据 同步 和 视图 的 服务 器 端 泻 染 。 它 用 到 了 MongoDB 和 Redis， 
数据 同步 层 是 由 ShareJS 提供 的 ， 支 持 冲 突 的 自动 解析 。 表 5-5 中 是 DerbyJS 的 主要 特性 。 


表 5-5 ”DerbyJS 的 主要 特性 

































































库 类 型 全 栈 框架 
功能 特性 有 支持 数据 库 的 ORM (Racer )， 同 构 
建议 应 用 有 服务 器 端 支持 的 单 页 Web 程序 
插件 架构 DerbyJS 插件 
文档 http://derbyjs.com/docs/derby-0.6 
热门 程度 GitHub 4000 颗 旺 
授权 许可 MIT 

5.7.1 设置 


运行 DerbyJS 的 例子 需要 安装 MongoDB 和 Redis。DerbyJS 的 文档 里 有 Mac OS、Linux 和 
Windows 上 的 安装 指南 。 

要 快速 创建 新 的 DerbyJS 项 目 ， 需 要 安装 derby 和 derby-starter。derby-starter 包 是 用 来 引导 
Derby 程序 的 : 

















mkdir example-derby-app 

cd example-derby-app 

npm init -f 

npm install --save derby derby-starter derby-debug 


Derby 程序 分 为 几 个 小 程序 。 创 建新 的 app 目录 ， 在 其 中 创建 三 个 文件 : indexjs、serverjs 和 
index.html。 下 面 这 个 简单 的 Derby 程序 演示 了 如 何 泻 染 模 板 。 
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代码 清单 5-5 ”Derby app/index.js 文件 


const 
+ 


app = module.exports = require('derby') 
ateApp('hello', __ filename); 


app.loadViews(_ dirname); 


app.ge 
cons 


t('/', (page, model) => { 
t message = model.at('hello.message'); 


message.subscribel(err => { 


if 
me 


和 去 
下 站 学 


(err) return next (err); 
ssage.createNull(''); 


page.render () ; 


文件 app/server.js 只 需要 加 载 derby-starter 模块 ， 代 码 如 下 所 示 : 


requir 


e('derby-starter') .run(_ dirname, { port: 8005 }); 





文件 app/index.html 演 染 了 一 个 输入 域 以 及 用 户 输入 的 消息 : 


<Body : 
Holl 
<h2> 


> 
er: <input value="{{hello.message}}"> 
{{hello.message}}</h2> 





品 





在 example-derby-app 目录 下 运行 node daerbyy/server.js 应 该 就 能 运行 这 个 程序 。 在 它 运 行 
起 来 之 后 ， 只 要 修改 app/index.html， 程 序 就 会 重启 ， 也 就 是 说 编辑 代码 和 模板 时 程序 会 自动 实时 
















































































更 新 。 
5.7.2 ”定义 路 由 

DerbyJS 中 的 路 由 是 用 derby-router 实现 的 。 因 为 是 基于 Express 的 ， 所 以 DerbyJS 的 路 由 API 
跟 服务 器 端 路 由 类 似 ， 浏览 器 中 用 的 也 是 这 个 路 由 模块 。 在 DerbyJS 程序 中 点 击 链接 时 ， 它 会 试 
着 在 客户 端 泻 染 响应 。 





为 DerbyJS 是 全 栈 框架 , 所 以 它 添加 路 由 的 方式 跟 本 章 中 讲 到 的 其 他 框架 不 太一 样 。 对 于 





























基本 的 路 由 而 言 ， 最 理想 的 添加 方式 是 添加 一 个 视图 。 打 开 apps/app/index.js， 月 
一 个 路 由 : 
app.get('hello', '/hello'); 
然后 打开 apps/app/Views/hello.pug， 添 加 一 个 简单 的 Pug 模板 : 
index: 
h2 Hello 
p Hello worild 


打开 apps/app/views/index.pug， 导 入 这 个 模板 : 


import 


如 果 你 
会 显示 新 的 





日 app .get 添加 





(STC=: "7 /hello”) 
之 前 运行 过 npm start ,这 个 程序 应 该 会 不 断 更 新 ,所 以 打开 http://localhost:3000/hello 








视图 。 
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模板 中 的 ingex: 那 行 是 视图 的 命名 空间 。 在 DerbyJS 中 ， 视 图 的 名 称 有 用 冒号 分 隔 的 命名 
空间 ， 所 以 刚刚 创建 的 是 nello:index。 这 样 做 的 出 发 点 是 为 了 将 视图 封 起 来 ， 以 免 在 大 型 项 
目 中 出 现 冲 突 。 

















5.7.3 REST API 


在 DerbyJS 中 创建 RESTful API 需要 用 Express 添加 路 由 和 路 由 处 理 器 。 DerbyJS 项 目 中 有 个 
serverjs 文件 ， 可 以 用 Express 创建 服务 器 。 打 开 server/routes.js， 你 会 发 现 一 个 路 由 的 例子 ， 是 
用 标准 的 Express 路 由 API 定 义 的 。 

在 服务 器 路 由 文件 中 ,可 以 用 app .use 装载 另 一 个 Express 程序 ， 所 以 可 以 将 REST API 作 
为 一 个 完全 独立 的 Express 程序 ， 然 后 让 作为 主 程序 的 DerbyJS 程序 装载 它 。 


5.7.4 优点 


DerbyJS 有 数据 库 模型 API 和 数据 同步 API。 你 可 以 用 它 搭建 单 页 Web 程序 和 现代 化 的 实时 
程序 。 因 为 它 自 带 对 WebSocket 和 同步 的 支持 ， 所 以 不 用 我 们 费心 去 选择 WebSocket 库 , 或 者 如 
何在 服务 器 端 和 客户 端 之 间 同 步 数 据 。 


















































后 ” 记 
尔 :“ 我 们 有 个 客户 想 要 做 一 个 实时 的 数据 可 视 化 项 目 ， 所 以 我 觉得 用 DerbyJS 应 该 不 


菲 尔 : 
错 。 但 DerbyJS 看 起 来 似乎 不 太 好 掌握 ， 所 以 我 担心 开发 人 员 可 能 不 太 愿 意 接 受 它 。” 
爱丽 丝 :“ 作 为 产品 开发 者 ， 我 几乎 找 不 出 让 产品 需求 跟 DerbyJS 架构 相 匹配 的 办 法 ， 所 


爱丽 和 
以 我 觉得 它 不 适合 我 们 的 项 目 。” 


5.7.5 ”弱点 


几乎 很 难说 服 有 服务 器 端 或 客户 端 库 使 用 经 验 的 人 使 用 DerbyJS。 比 如 说 ， 那 些 喜 欢 React 
的 客户 端 开发 人 员 通 常 都 不 想 用 DerbyJS。 那 些 熟 悉 WebSocket, 喜欢 做 REST API 或 MVC 项 目 
的 服务 器 端 开发 人 员 也 没有 学 习 DerbyJS 的 动力 。 








5.8 Flatiron.js 


Flatiron 是 Web 框架 ， 有 URL 路 由 、 数 据 管理 、 中 间 件 、 插 件 和 日 志 功能 。 跟 大 多 数 Web 
框架 不 同 ，Flatiron 的 模块 在 设计 时 就 考虑 了 耦合 性 ， 所 以 可 以 分 开 使 用 。 你 甚至 可 以 在 自己 的 
项 目 中 使 用 其 中 一 个 或 多 个 模块 。 比 如 说 ， 如 果 你 喜欢 日 志 模 块 ， 可 以 把 它 放 到 一 个 Express 项 
目 中 。Flatiron 的 URL 路 由 和 中 间 件 层 不 是 用 Express 或 Connect 写 的 ， 但 它 的 中 间 件 能 跟 Connect 
兼容 。 表 5-6 中 是 Flatiron 的 特性 。 












































表 5-6 Flatiron 的 特性 
















































































库 类 型 模块 化 MVC 框架 
功能 特性 数据 库 管理 层 ( Resourceful )， 解 而 的 可 重用 模块 
建议 应 用 轻 量 的 MVC 程序 ， 在 其 他 框架 中 使 用 Flatiron 模块 
插件 架构 Broadway 插件 API 
文档 https://github.com/flatiron 
热门 程度 GitHub 1500 颗 星 
授权 许可 MIT 
5.8.1 设置 





我 们 需要 全 局 安装 Flatiron 命令 行 工 具 来 创建 新 的 Flatiron 项 目 : 


npm install -9 flatiron 
flatiron create example-flatiron-app 


后 面 这 条 命令 会 创建 一 个 新 目录 ,其 中 有 package.json 和 必要 的 依赖 项 。 运行 npm install 
安装 依赖 项 ， 然 后 用 npm start 启动 这 个 程序 。 

主 文件 app.js 看 起 来 跟 典 型 的 Express 程序 差不多 : 

const flatiron = require('flatiron'); 


const path = require('path'); 
const app = flatiron.app; 


app.config.file({ file: path.join(_ dirname, 'config', 'config.json') }); 
app.use (flatiron.plugins.http); 
app.router.get('/', () => { 

this.res.json({ 'hello': 'world' }) 


的 过 


app.start (3000);，; 
然而 它 的 路 由 器 既 不 同 于 Express， 也 不 同 于 Koa。 它 用 this .res 返回 响应 ， 而 不 是 给 应 
答 器 回调 的 参数 。 我 们 来 仔细 看 看 Flatiron 的 路 由 。 


5.8.2 定义 路 由 


Flatiron 的 路 由 库 叫 Director。 它 既 能 用 于 服务 器 端 路 由 ,也 支持 浏览 器 中 的 路 由 ， 所 以 可 以 
用 来 制作 单 页 程序 。Director 使 用 Express 风格 的 HTTP 动词 路 由 : 


router.get('/example', example); 
router.post('/example', examplePost);} 


路 由 可 以 有 参数 ， 并 且 参 数 可 以 用 正则 表达 式 定 义 : 


router.param('id', /([\\w\\-]+)/); 
router.on('/pages/:id', pagelId => {}); 
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要 生成 响应 ， 用 res .writeHead 发 送 响应 头 部 ， 用 res .eng 发 送 响应 的 主体 部 分 : 


router.get('/', () => { 
this.res.writeHead(200, { 'content-type': 'text/plain' }) 
this.res.end('Hello, World'); 

se 


也 可 以 定义 一 个 路 由 表 对 象 ， 把 路 由 API 当 作 类 来 用 。 这 种 用 法 需要 初始 化 一 个 新 的 路 由 上 需 ， 
然后 用 dispatcuh 方法 来 处 理 HTTP 请 求 : 


const http = require('http'); 
const director = require('director'); 
const router = new director.http.Router({ 
'/example': { 
get: () => { 
this.res.writeHead(200, { 'Content-Type': 'text/plain' }) 
this.res.end('hello world'); 
lj 
} 
j 
const server = http.createServer((req, res) => 
router.dispatch (req, res); 

















) ) ; 
把 路 由 API 当 作 类 还 有 一 个 好 处 , 这样 可 以 接 人 流 API。 也 就 是 说 能 用 更 加 快速 便捷 的 方式 
处 理 比 较 大 的 请 求 ， 比 如 在 需要 解析 上 传 数据 并 提前 退出 时 ， 这 种 方式 更 好 : 


const director = require('director'); 
const router = new director.http.Router (); 
































router.get('/', { stream: true }, () => { 
this.req.on('data', (chunk) => { 
console.log(chunk); 
下 
3 


Director 有 一 个 带 作用 域 的 路 由 API， 很 适合 用 来 创建 REST API。 








5.8.3 REST API 


在 Flatiron 中 ， 可 以 用 Express 风格 的 标准 HTTP 动词 方法 创建 REST API， 或 者 用 Director 
的 作用 域 路 由 功能 。 这 个 功能 可 以 基于 URL 的 组 成 和 URL 的 参数 对 路 由 分 组 : 
router.path(/\/users\/(\w+)/, () => { 
this.get ((id) => {}); 
this.delete((id) => {}); 
this.put((id) => {}); 
2 
Flatiron 还 有 一 个 高 层 的 REST 封装 器 Resourceful, 支持 CouchDB、MongoDB、Socket.IO 和 


数据 校 验 。 
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5.8.4 优点 


框架 想得到 注意 是 很 难 的 ， 所 以 Flatiron 























的 解 耦 设计 是 它 最 大 的 优点 。 你 可 以 脱离 整个 
使 用 其 中 的 模块 。 比 如 说 ， 很 多 项 目 都 在 用 Winston 日 志 模 块 ， 但 没 用 Flatiron 的 其 他 部 分 。 








意味 着 Flatiron 的 某 些 部 分 会 得 到 开源 社区 的 良好 贡献 。 
端 和 服务 器 端 开 发 中 都 可 以 用 。Director 的 API 跟 
Express 风格 的 路 由 API 也 不 同 : Director 有 经 过 简化 的 流 API， 路 由 对 象 会 在 路 由 执行 前 后 发 出 























Director URL 路 由 API 是 同 构 的 ， 客 户 
































事件 。 


不 同 于 大 多 数 Node Web 框架 ，Flatiron 有 个 捐 


持 的 插件 更 容易 。 








点 评 


5.8.5 ”弱点 


在 大 型 MVC 项目 中 ，Flatiron 不 像 其 他 机 


迪 娜 :“ 我 喜欢 Flatiron 的 模块 设计 ， 插 件 











EE 架 


>» 





有 件 管理 器 。 因 此 在 Flatiron 项 目 中 使 用 社区 支 


管理 器 也 很 棒 。 我 已 经 想到 要 做 哪些 插件 了 。” 


匡 架 那么 好 用 。 比 如 在 设置 上 ，Sails 就 比 它 更 容易 。 


如 果 要 做 几 个 中 等 规模 的 传统 Web 程序 ，Flatiron 应 该 很 好 用 。Flatiron 的 配置 能 力 是 加 分 项 , 但 


一 定 要 先 评估 一 下 其 他 选项 。 


























LoopBack 是 个 强大 的 竞争 对 手 ， 也 是 本 章 介 绍 的 最 后 一 个 框架 。 


5.9 LoopBack 














LoopBack" 是 StrongLoop 创建 的 ， 这 家 公司 为 Node Web 程序 的 开发 提供 了 一 些 商业 支持 服 
务 。LoopBack 是 个 API 框架, 但 它 的 功能 特性 很 适合 跟 数 据 库 配 合 , 也 很 适合 跟 MVC 程序 配合 。 
它 甚 至 还 有 个 浏览 和 管理 REST API 的 Web 界面 。 如 果 你 要 给 移动 端 和 桌面 端 程序 找 个 创建 
Web API 的 框架 ， 那 就 是 LoopBack 了 。 请 查看 表 5-7 了解 LoopBack 的 详情 。 


表 5-7 LoopBack 的 特性 































































































库 类 型 API 框 架 

功能 特性 ORM、API 用 户 界面 、WebSocket、 客 户 端 SDK (包括 iOS ) 
建议 应 用 支持 多 客户 端的 API ( 移动 端 、 桌面 端 、Web ) 

插件 架构 Express 中 间 件 

文档 http://loopback.io/doc/ 

热门 程度 GitHub 6500 颗 星 

授权 许可 双 许 可 : MIT 和 StrongLoop 认购 协议 














Q@ 本 节 内 容 基 于 Loopback 3.0 之 前 的 版 本 ， 用 npm i -g loopback-cli 安装 3.0 之 后 的 版 本 ， 替 代 slc 的 工 























具 为 lb。 
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LoopBack 是 开源 的 ， 自 从 StrongLoop 被 IBM 收购 后 ， 这 个 框架 已 经 得 到 了 主流 商业 认可 ， 
这 让 它 在 Node 社区 里 脱颖而出 。LoopBack 有 个 Yeoman 后 成 器 ， 可 以 快速 搭建 起 程序 脚手架 
下 一 节 将 介 纤 办 如 何 创建 一 个 全 新 的 LoopBack 程序 。 








5.9.1 设置 


创建 新 的 LoopBack 项 目 需 要 用 | StrongLoop 的 命令 行 工 具 。 全 局 安装 strongloop 包 ， 以 便 
可 以 通过 slc 命令 使 用 命令 行 工具 。 这 个 包 里 有 进程 管理 功能 ， 但 我 们 对 LoopBack 项 目 生成 器 
更 感 感 兴 


npm install -9 strongloop 
slc loopback 


StrongLoop 命令 行 工具 会 带 着 你 一 步 步 完成 新 项 目的 创建 。 输 入 项 目的 名 字 ， 然 后 选择 
api-server 程序 框架 。 生 成 器 装 好 项 目的 依赖 项 后 ,会 显示 一 些 提示 ， 告 诉 你 如 何 开始 新 项 目 。 
看 起 来 应 该 是 图 5-2 的 样子 。 























@ae 3. alex@Alexs-MacBook-Pro: ~/Documents/Code (zsh) 
slc loopback | 
| | RS 
|--(o)--| | Let's create a LoopBack 
“`“--------- 2 | application! | 
AA i 
省 


? What's the name of your application? 
? Enter name of the directory to contain the project: 
te loopback-example/ 
info change the working directory to loopback-example 


? What kind of application do you have in mind? 


Generating .yo-rc.json 


I'm all done. Running for you to install the required dependencies. If this fails, +t 
ry running the command yourself. 


.editorconfig 
.jshintignore 
e .jshintrc 
ate Server/boot/root .js 
te server/middleware.json 
reate server/middleware.production.json 


图 5-2 ”LoopBack 的 项 目 生 成 器 











输入 node .运行 这 个 项 目 , 用 slc loopback:model 创建 模型 。 在 设置 新 的 LoopBack 
项 目 时 ， 会 经 常用 到 slc 命令 。 

在 项 目 运行 时 ,你 应 该 可 以 在 http://0.0.0.0:3000/explorer/ 访问 到 API 管理 界面 。 点 击 User 展开 
用 户 端点 ， 会 有 一 个 列表 显示 所 有 可 用 的 API 方 法 , 包括 PUT /Users 和 DELETE /Users/{iqd)} 
等 标准 的 RESTful 路 由 ， 如 图 5-3 所 示 。 




















ee 沿 StrongLoop APlExplorer x | Alex | 


€ SC | 0.0.0.0:3000/explorer/ 六 @ z= 











: 擅 StrongLoop API Explorer Token Not Set 





loopback-example 
User Show/Hide List Operations Expand Operations 
| oer | /Users Find all instances of the model matched by filter from the data source. 
EE /Users Update an existing model instance or insert a new one into the data source. 
[ei /Users Create a new instance of the model and persist it into the data source. 
/Users/{id} Find a model instance by id from the data source. 
加 /Users/{id} Check whether a model instance exists in the data source. 
El /Users/{id} Update attributes for a model instance and persist it into the data source. 
| bar /Users/{id} Delete a model instance by id from the data source. 
四 /Users/{id}/accessTokens Queries accessTokens of User. 
Ge /Users/{id}/accessTokens Creates a new instance in accessTokens of this model. 
/Users/{id}/accessTokens Deletes all accessTokens of this model. 
He 





图 5-3 显示 User 路 由 的 StrongLoop API 管理 界面 





5.9.2 定义 路 由 


LoopBack 中 的 路 由 可 以 在 Express 这 个 层面 添加 。 创 建 server/boot/routes.js， 通 过 LoopBack 
路 由 器 实例 添加 一 个 新 路 由 : 


module.exports = (app) => { 
const router = app.loopback.Router();} 
router.get('/hello', (req, res) => { 
res.send('Hello, world'); 
本 学 
app.use (router); 
二 


访问 http://localhost:3000/hello 会 看 到 响应 消息 Hello,world。 不 过 在 LoopBack 项 目 中 ， 一 般 
不 用 这 样 添加 路 由 。 只 有 需要 特殊 的 API 端点 时 才 需 要 这 样 , 一 般 的 路 由 都 是 在 生成 模型 时 自动 
添加 的 。 








5.9.3 RESTAPI 


在 LoopBack 项目 中 ,用 模型 生成 器 是 创建 REST API 最 轻松 的 办 法 。slc 命令 有 这 个 功能 。 
比如 说 ， 如 果 要 用 slc looppack:moael 添加 名 为 product 的 新 模型 ， 则 运行 : 





slc loopback:model product 
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slc 命令 会 带 着 你 一 步 步 创 建 ， 让 你 选择 这 个 模型 是 否 只 用 在 服务 器 端 , 并 设置 一 些 属性 和 
校 验 器 。 创 建 好 后 ， 你 可 以 看 一 下 对 应 的 JSON 文件 。 用 这 样 的 JSON 文件 来 定义 模型 的 行为 更 
轻便 ， 其 中 包括 了 你 之 前 指定 的 所 有 属性 。 

如 果 还 需要 添加 更 多 的 属性 ， 可 以 用 slc loopback:property， 随 时 添加 都 行 。 
























































点 评 
菲 尔 :“ 我 们 喜欢 LoopBack， 因 为 它 可 以 快速 添加 RESTful 资 源 ,并且 它 还 有 API 管理 界 
面 。 但 就 我 个 人 而 言 ， 是 因为 它 看 起 来 很 灵活 ， 能 支持 我 们 之 前 做 的 MVC Web 程序 。 我 们 可 
以 把 之 前 的 数据 库 挂 上 ， 把 那些 项 目 迁 移 到 Node 上 来 
爱丽 丝 :“ 这 是 唯一 一 个 真正 面向 iOS、Android 和 富 Web 客户 端的 框架 。 LoopBack 有 iOS 
和 Android 的 客户 端 库 ， 对 于 我 们 这 些 依 靠 移动 端 程序 的 产品 开发 人 员 来 说 ， 这 很 重要 。 


5.9.4 优点 


即便 是 这 样 简短 的 介绍 ， 也 能 清楚 地 表明 LoopBack 帮 有 我们 免除 了 繁琐 的 套路 化 代码 。 它 的 
命令 行 工具 几乎 可 以 生成 一 个 完整 的 RESTful Web API 程 序 ， 甚 至 包括 数据 库 模 型 和 校 验 。 同 
时 ，LoopBack 对 前 端 代码 没有 太 多 限制 。 它 还 让 你 考虑 哪个 模型 可 以 通过 浏览 器 访问 ， 哪 个 只 
能 在 服务 器 端 使 用 。 有 些 框 架 在 这 个 问题 上 犯 了 错误 ， 把 所 有 事情 都 推 给 了 浏览 器 。 

如 果 有 需要 跟 Web API 通话 的 移动 端 程序 ， 可 以 看 看 LoopBack 的 客户 端 SDK。 它 支持 API 
集成 ， 可 以 给 iOS 和 Android 推送 消息 。 
























































5.9.5 ”弱点 


LoopBack 基于 JSON 的 模型 API 跟 大 部 分 JavaScript 数据库 API 都 不 同 。 所 以 可 能 要 花 些 时 
间 才 能 搞 懂 如 何 将 它 映射 到 已 有 的 数据 库 模 式 上 。 男 外 ， 因 为 HTTP 层 是 基于 Express 的 ， 所 以 
在 某 种 程度 上 会 受 限于 Express 所 支持 的 功能 。 尽 管 Express 是 个 很 好 的 HTTP 服务 器 库 ， 但 还 
有 支持 更 现代 化 的 API 的 新 库 。LoopBack 没有 特定 的 插件 API, 虽然 可 以 用 Express 中 间 件 , 但 
毕竟 不 如 Flatiron 或 hapi 的 插件 API 方 便 。 

这 是 本 章 介绍 的 最 后 一 个 框架 。 在 开始 下 一 章 之 前 ,我 们 先 做 个 简单 的 比较 ， 以 便 帮 你 为 下 
一 个 项 目 选 出 正确 的 框架 。 















































5.10 比较 


如 果 你 一 直 在 看 本 章 中 的 点 评 ， 可 能 已 经 决定 要 用 哪个 框架 了 。 如 果 还 没 决 定 ， 本 章 后 续 
内 容 会 对 这 些 框 架 的 好 处 做 个 比较 。 如 果 你 还 是 搞 不 清楚 ， 可 以 根据 图 5-4 中 提出 的 问题 找到 


答案 。 











你 要 找 哪 种 框架 ? 


全 栈 服务 器 端 MVC HITP 库 
DerbyJS 哪 种 MVC? 什么 样 的 路 由 API? 




































Rails/Django 
Sails.js 
Web API Connect ES6 
API tools and GUI? Databases/views? Koa 
是 不 是 是 不 是 是 不 是 
LoopBack|| Kraken 同 构 ? Hapi Flatiron Hapi 





| 


图 5-4 选择 Node 框架 


乍 一 看 , 那些 热门 的 Node 服务 器 端 框 架 都 差不多 。 他 们 提供 了 轻便 的 HTTP API, 使 用 了 服 
务 器 端 模 型 ， 而 不 是 PHP 那 种 页 面 模型 。 但 它们 在 设计 上 的 差别 对 项 目的 影响 很 大 ， 所 以 要 做 
个 比较 的 话 ， 应 从 HTTP 层 开 始 。 


HTTP 服务 器 和 路 由 


大 多 数 Node 框架 都 是 基于 Connect 或 Express 的 。 本 章 有 三 个 完全 不 依赖 Express， 提 出 了 
自己 的 HTTP API 方案 的 框架 : Koa、hapi 和 Flatiron。 

Koa 也 是 写 Express 的 那个 作者 写 的 ， 但 其 用 更 加 现代 化 的 JavaScript 特性 实现 了 全 新 的 工作 
方式 。 如 果 你 喜欢 Express， 也 喜欢 用 ES2015 生成 器 语法 ， 可 以 试 试 Koa。 

hapi 的 服务 器 和 路 由 API 是 高 度 模块 化 的 ， 感 觉 跟 Express 那 一 类 不 一 样 。 如 果 你 觉得 
Express 的 语法 比较 乾 软 ， 可 以 试 试 hapi。hapi 让 HTTP 服务 器 变 得 更 容易 处 理 ， 如 果 你 想 把 服 
务 器 连 起 来 ， 或 者 要 做 服务 器 集群 ，hapi 比 Express 及 其 后 裔 们 好 用 。 

Flatiron 的 路 由 器 能 跟 Express 兼容 ， 不 过 功能 更 多 。 跟 Express 风格 的 中 间 件 栈 不 同 ，Flatiron 
的 路 由 器 用 了 路 由 表 ， 还 会 发 出 事件 。 我 们 可 以 给 Flatiron 的 路 由 器 传递 一 个 对 象 常量 。 这 个 路 
右 还 能 用 在 浏览 器 中 ， 如 果 你 的 服务 器 端 开 发 人 员 还 要 做 现代 化 的 客户 端 开发 ， 那 跟 React 路 
由 器 之 类 的 技术 比 起 来 ，Flatiron 路 由 器 会 让 他 们 觉得 更 舒服 。 





























































































































5.11 编写 模块 化 代码 


在 本 章 介绍 的 框架 中 ， 有 些 不 是 直接 支持 插件 的 ， 但 都 可 以 通过 某 种 方式 进行 扩展 。 基 于 
Express 的 框架 可 以 用 Connect 中 间 件 , 但 hapi 和 Flatiron 有 它们 自己 的 插件 API。 定 义 良 好 的 插 
件 API 非常 实用 ， 因 为 它们 能 让 新 用 户 更 轻松 地 对 框架 进行 扩展 。 

如 果 是 Sailsjs 或 LoopBack 这 样 的 大 型 MVC 框架 ,插件 API 会 让 创建 新 项 目 变 得 容易 得 多 。 
LoopBack 提供 了 一 个 强力 的 项 目 管理 工具 ， 弱 化 了 对 插件 API 的 依赖 程度 。 在 npm 的 StrongLoop 
主页 上 ， 有 很 多 与 LoopBack 相关 的 项 目 为 Angular 和 数据 库 等 产品 提供 支持 。 


5.12 用户 选 择 


我 们 已 经 为 本 章 中 定义 的 用 户 提 供 了 足够 的 背景 知识 , 他 们 可 以 为 自己 的 下 一 个 项 目 选 出 合 
适 的 框架 了 。 
非 尔 :“ 最 后 我 选 了 LoopBack。 这 是 个 艰难 的 决定 ， 因 为 Sails 和 Kraken 都 有 我 们 团队 喜欢 
的 点 ， 但 我 们 觉得 LoopBack 有 更 强 的 长 期 支持 ， 而 且 可 以 省 掉 大 量 的 服务 器 端 开 发 工作 。 

纳 迪 娜 :“ 作 为 一 名 开源 开发 人 员 ， 我 把 票 投 给 了 Flatiron。 它 可 以 适应 我 在 做 的 各 种 项 目 。 
比如 说 ， 有 些 项 目 只 要 用 Winston 和 Director 就 好 ， 其 他 的 则 会 用 整个 Flatiron。” 

爱丽 丝 :“ 我 选 的 是 hapi。 它 是 极 简 风格 的 ， 我 能 根据 项 目的 需求 对 它 进行 调整 。hapi 大 部 
分 都 是 Node 代码 ， 并 是 不 依赖 特定 的 框架 ， 所 以 我 觉得 它 合 适 。” 




























































































5.13 ”总 结 


口 Koa 轻便 、 极 简 ， 在 中 间 件 中 使 用 ES2015 生成 器 语法 。 适 合 依赖 外 部 Web API 的 单 页 
Web 程序 。 

口 hapi 的 重点 是 HTTP 服务 器 和 路 由 。 适 合 由 很 多 小 服务 器 组 成 的 轻便 后 台 。 

口 Flatiron 是 一 组 解 耦 的 模块 ， 既 可 以 当 作 Web MVC 框架 来 用 , 也 可 以 当 作 更 轻便 的 Express 
库 。Flatiron 跟 Connect 中 间 件 是 兼容 的 。 

口 Kraken 是 基于 Express 的 ， 添 加 了 安全 特性 。 可 以 用 于 MVC。 

D Sails.js 是 Rails/Django 风格 的 MVC 框架 。 有 ORM 和 模板 系统 。 

口 DerbyJS 是 个 同 构 框 架 ， 适合 实时 程序 。 

口 LoopBack 帮 我 们 省 掉 了 写 套 路 化 代码 的 工作 。 它 可 以 快速 生成 带 有 数据 库 支 持 的 REST 
API， 并 有 个 API 管理 界面 。 
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本 章 内 容 

口 了 解 Connect 和 Express 是 用 来 做 什么 的 

口 中 间 件 的 使 用 及 创建 

口 Express 程序 的 创建 及 配置 

口 用 Express 中 的 关键 技术 处 理 错误 、 演 染 视 图 和 表单 

口 用 Express 的 架构 化 技术 实现 路 由 、REST API 和 用 户 认证 














本 书 在 第 3 章 中 搭建 了 一 个 简单 的 Express 程序 。 本 章 会 进一步 深入 研究 Express 和 Connect。 
很 多 Web 开发 人 员 都 在 用 这 两 个 热门 的 Node 模块 。 本 章 会 介绍 如 何 用 最 常用 的 模式 搭建 Web 
程序 和 REST API。 





Connect 和 Express 
下 面 一 节 将 要 讨论 的 概念 可 以 直接 套用 到 Express 框架 上 ， 因 为 Express 就 是 在 Connect 
的 基础 上 ， 通 过 添加 高 层 糖衣 扩展 和 搭建 出 来 的 。 看 完 这 一 节 ， 你 会 对 Connect 中 间 件 的 工作 
机 制 ， 以 及 如 何 通过 组 装 这 些 组 件 来 创建 一 个 程序 有 个 确切 的 认识 。 其 他 Node Web 框架 的 工 
作 机 制 也 差不多 ， 青 明白 Connect 后 ， 将 来 学 习 新 框架 会 更 容易 入 门 。 


我 们 先 来 看 一 下 如 何 创建 一 个 基本 的 Connect 程序 ， 然 后 再 介绍 如 何 用 更 流行 的 Express 搭 
建 稍 复杂 一 些 的 Express 程序 。 








6.1 Connect 

















本 节 要 讲 Connect。 内 容 包 括 如 何 用 中 间 件 搭建 简单 的 Web 程序 ， 以 及 中 间 件 的 顺序 的 重要 
性 。 在 将 来 搭建 更 加 模块 化 的 Express 程序 时 ， 你 仍然 会 用 到 这 些 知识 。 
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6.1.1 创建 Connect 程序 


Connect 以 前 是 Express 的 基础 ， 但 实际 上 只 用 Connect 也 能 做 出 完整 的 Web 程序 。 用 下 面 
的 命令 下 载 并 安装 Connect: 

$ npm install connect@3.4.0 

最 简单 的 Connect 程序 应 该 是 这 样 的 : 


const app = require('connect') (); 

app.use( (req, res, next) => { 
res.end('Hello, world!'); 

1 

app.listen(3000); 


这 个 程序 (代码 在 ch06-connect-and-express/hello-world 里 ) 会 用 Hello,World! 给 出 响应 。 传 
给 app .use 的 函数 是 个 中 间 件 ， 它 以 文本 Hello,World! 作为 响应 结束 了 请 求 处 理 过 程 。 中 间 件 
是 所 有 Connect 和 Express 程序 的 基础 。 下 面 来 看 一 下 细节 。 


6.1.2 了 解 Connect 中 间 件 的 工作 机 制 


Connect 中 间 件 就 是 JavaScript 函数 。 这 个 函数 一 般 会 有 三 个 参数 : 请 求 对 象 、 响 应 对 象 ， 以 
及 一 个 名 为 next 的 回调 函数 。 一 个 中 间 件 完成 自己 的 工作 ， 要 执行 后 续 的 中 间 件 时 ， 可 以 调用 
这 个 回调 函数 。 

在 中 间 件 运行 之 前 ，Connect 会 用 分 派 器 接管 请 求 对 象 ， 然 后 交 给 程序 中 的 第 一 个 中 间 件 。 
6-1 是 一 个 典型 的 Connect 程 序 的 示意 图 ， 由 分 派 器 和 一 组 中 间 件 组 成 ， 这 些 中 间 件 包括 日 志 
记录 、 消 息 体 解 析 器 、 静 态 文件 服务 器 和 定制 中 间 件 。 




















































































































GET /img/logo.png POST /usersave 
. 
Dispatcher O19 @@ 分 派 器 收 到 请 求 ， 把 它 传 给 第 一 个 中 间 件 
next () 
@ 记录 请 求 日 志 ， 并 用 next () 传 给 下 一 个 中 间 件 
logger © 
next () @ 如 果 有 ， 请 求 体会 被 解析 ， 并 用 next () 传 给 
下 一 个 中 间 件 
bodyParser 【37 
next () @@ 如 果 请 求 的 是 静态 文件 ， 用 那个 文件 做 响应 ， 
一 一 不 再 调用 next () ， 否 则 请 求 进入 下 一 个 中 间 件 
(4 res.end() static OO 
next () 
+ @@ 请 求 被 一 个 定制 的 中 间 件 处 理 好 ， 响 应 结束 
CUstorMiaaleware | res.end() (5) 














图 6-1 ”两 个 HTTP 请 求 穿 过 Connect 服务 器 的 生命 周期 
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由 此 可 见 ， 借 助 中 间 件 API， 可 以 把 一 些小 的 构件 块 组 合 到 一 起 ， 实 现 复杂 的 处 理 逻 辑 。 你 
会 在 下 一 节 看 到 如 何 进行 这 种 组 合 。 
6.1.3 组 合 中 间 件 


Connect 中 的 use 方法 就 是 用 来 组 合 中 间 件 的 。 我 们 先 来 定义 两 个 中 间 件 函数 ， 然 后 把 它们 
都 添加 到 程序 中 。 其 中 一 个 是 之 前 那个 例子 里 的 hello 函数 ， 另 外 一 个 是 1ogger。 


代码 清单 6-1 使 用 多 个 Connect 中 间 件 








const connect = require('connect'); 

Ee res, en 。 输出 HTTP 请 求 的 方法 
console.log('®%s %s', req.method, req.url); % 
et 9 S S 和 URL 并 调用 next () 

} 

function hello(req, res) { | < 用 “hello world” 响 
res.setHeader('Content-Type', 'text/plain'); 


1 及 : 吉 > 
res.end('hello world'); :应 HTTP 请 求 


} 

connect () 
.use (logger) 
.use (hello) 
.listen(3000); 


这 两 个 中 间 件 的 名 称 签名 不 一 样 : 一 个 有 next， 一 个 没有 。 因 为 后 面 这 个 中 间 件 完成 了 HTTP 
啊 应 ， 再 也 不 需要 把 控制 权 交 还 给 分 派 咒 了 。 

如 前 所 示 ，use () 函数 返回 的 是 Connect 程序 的 实例 ,支持 方法 链 。 不 过 并 不 一 定 要 把 .use () 
链 起 来 ， 像 下 面 这 样 也 可 以 : 

const app = connect () ; 

app.use (logger); 


app.use (hello); 
app.listen(3000); 


有 了 这 个 简单 的 人 门 程序 ， 我 们 来 看 看 为 什么 .use () 的 调用 顺序 很 重要 ， 以 及 如 何 策略 地 
用 这 个 顺序 调整 程序 的 工作 方式 。 


6.1.4 中 间 件 的 顺序 


中 间 件 的 顺序 会 对 程序 的 行为 产生 显著 影响 。 漏 掉 next () 能 停止 执行 ， 也 可 以 通过 组 合 中 
间 件 实现 用 户 认 证 之 类 的 功能 。 

中 间 件 不 调用 next 会 怎么 样 ? 在 之 前 那个 人 门 程序 中 ，1logger 是 第 一 个 中 间 件 ， 然 后 是 
hello。Connect 将 日 志 输 出 到 控制 台 ， 然 后 返回 HTTP 响应 。 如 果 像 下 面 这 样 把 顺序 倒 过 来 会 
怎么 样 ? 
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代码 清单 6-2 ”错误 : hello 中 间 件 组 件 在 1ogger 组 件 前 面 


const connect = require('connect'); 
f i 中 和 、 
unction logger(req, res, next) { < 总 是 调用 next ()， 所 以 


SC ss $s', req.method, req.url); 后 续 中 间 件 总 会 被 调用 
} 
function hello(req, res) { 他 一 不 会 调用 next ()， 因 为 
res.setHeader('Content-Type', 'text/plain'); 组 件 响应 了 请 求 , 
4 月 


res.end('hello world'); 
} 


const app = connect() 


(ee 全] 因为 hello 不 调用 next ()， 所 以 


.use (logger) A 
.listen(3000) ; logger 永远 不 会 被 调用 


这 个 例子 是 先 调用 hello， 程 序 如 期 返回 响应 结果 。 但 logger 永远 也 不 会 执行 ， 因 为 hello 
没有 调用 next () ， 所 以 控制 权 没 有 交 回 给 分 派 器 ， 它 也 不 能 调用 下 一 个 中 间 件 。 也 就 是 说 ， 如 
果菜 个 中 间 件 不 调用 next () ， 那 链 在 它 后 面 的 中 间 件 就 不 会 被 调用 。 

6-2 给 出 了 这 个 例子 是 如 何 跳 过 logger 的 ， 以 及 如 何 改正 。 


























HTTP GET 请 求 





HTTP G7 请 求 






























































“ 设 定 头 信息 输出 请 求 信息 
hello “res.end(): 将 文本 发 送 给 浏览 器 logger ”| .调用 next () --; 
本 “ 设 定 头 信息 | 
人 Rello | .res.end() ,将 文本 发 送 给 浏览 器 | | 
一 浏览 器 收 到 响应 日 志 消 息 显示 在 控制 台 里 | 一 
























浏览 器 收 到 响应 








图 6-2 ”中 间 件 的 顺序 很 重要 
正如 你 所 看 到 的 ， 像 这 样 把 hello 放 到 1ogger 前 面 并 没什么 用 ， 但 只 要 运用 得 当 ， 排 序 

是 可 以 带 来 好 处 的 。 

6.1.5 创建 可 配置 的 中 间 件 


介绍 完 中 间 件 的 基础 知识 , 可 以 深入 研究 一 些 细节 了 。 接 下 来 先 看 看 如 何 创建 更 通用 的 可 重 
用 中 间 件 。 





















































100 第 6 章 深入 了 解 Connect 和 Express 








为 了 做 到 可 配置 ， 中 间 件 一 般 会 遵循 一 个 简单 的 惯例 : 用 一 个 函数 返回 男 一 个 函数 ( 闭 包 )。 
这 种 可 配置 中 间 件 的 基本 结构 如 下 所 示 : 


function setup(options) { 
// 设置 远 辑 








在 这 里 做 中 间 
return function(req, res, next) { 件 的 初始 化 


// 中 间 件 逻辑 


即使 被 外 部 函数 返回 了 ， 


: 仍然 可 以 访问 options 


} 
这 种 中 间 件 的 用 法 如 下 : 
app.use(setup({some: 'options' })); 


注意 app .use 中 的 setup 函数 ， 之 前 放 的 是 对 中 间 件 函数 的 引用 。 

本 节 会 用 这 项 技术 构建 一 个 可 重用 、 可 配置 的 中 间 件 : 数据 格式 可 配置 的 logger。 

前 面 创建 的 logger 中 间 件 不 可 配置 。 要 输出 请 求 的 req.methogd 和 reg.url 是 写 死 在 代 
码 里 的 。 如 果 将 来 想 改变 logger 输出 的 信息 该 怎么 办 ? 

在 实际 工作 中 , 可 配置 的 中 间 件 跟 之 前 创建 的 不 可 配置 中 间 件 用 起 来 是 一 样 的 ,只 是 可 以 向 
其 中 传人 额外 的 参数 来 改变 它 的 行为 。 可 配置 中 间 件 的 使 用 和 下 面 这 个 例子 差不多 ，1ogger 能 
接收 一 个 字符 串 参 数 ， 描 述 输出 的 日 志 格 式 : 

const app = connect () 


.use(logger(':method :url')) 
.use (hello); 


为 了 让 logger 可 配置 ， 需 要 先 定义 一 个 setup 函数 ， 它 能 接受 一 个 字符 串 参 数 ( 此 例 中 
名 为 format )。setup 的 返回 结果 是 一 个 函数 ， 即 Connect 所 用 的 中 间 件 。 即 便 被 setup 返回 
后 ， 这 个 中 间 件 函数 仍 能 访问 format ， 因 为 它们 是 在 同一 个 JavaScript 闭 包 内 定义 的 。logger 
会 将 format 中 的 标记 替换 为 reg 对 象 中 的 相应 属性 ， 输 出 到 控制 台 ， 然 后 调用 next ()。 代码 
如 下 所 示 。 


代码 清单 6-3 ”可 配置 的 Connect 中 间 件 logger 


setup 函数 可 以 用 不 
同 的 配置 调用 多 次 











































































































function setup (format) { 
const regexp = /:(\w+)/g; 


logger 组 件 用 正则 





表达 式 匹 配 请 求 属性 
return function createLogger (req, res, next) { 2 = = 
const str = format.replace(regexp, (match, property) => { <  € Connect 使 用 的 真 
return req[lproperty]; 用 正则 表达 式 格式 化 实 logger 组 件 
学 请 求 的 日 志 条 目 
console.log(str); < 将 日 志 条 目 输 出 到 
Mewes 4 |] 将 控制 权 交 给 下 控制 台 


一 个 中 间 件 组 件 
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} 直接 导出 logger 

module.exports = setup; 二 | 的 setup 函数 

现在 这 个 logger 成 了 可 配置 的 中 间 件 ， 所 以 ， 可 以 在 同一 程序 中 给 .use () 传 人 不 同 配置 
的 1ogger， 或 者 在 将 来 开发 的 程序 中 重用 这 段 代 码 。 整 个 Connect 社区 都 在 用 这 种 可 配置 中 间 
件 的 概念 ， 并 且 为 了 保持 一 致 性 ， 所 有 Connect 核心 中 间 件 都 是 可 配置 的 。 

要 使 用 代码 清单 6-3 中 的 中 间 件 logger, 需要 给 它 传 一 个 字符 串 , 指明 请 求 对 象 中 的 属性 。 
比如 .use(setup(' :method :url')) 会 输出 所 有 请 求 的 HTTP 方 法 (GET、POST 等 ) 和 URL。 

在 转战 Express 之 前 ， 先 看 看 Connect 对 错误 处 理 的 支持 。 


6.1.6 ”使 用 错误 处 理 中 间 件 


所 有 程序 都 有 错误 , 不管 是 在 系统 层面 还 是 在 用 户 层面 , 面 对 错 误 , 甚至 是 无 法 预料 的 错误 ， 
做 到 未 雨 绸 缪 才 是 明 逢 之 举 。Connect 中 有 一 种 用 来 处 理 错误 的 中 间 件 变 体 ， 跟 常规 的 中 间 件 相 
比 ， 除 了 请 求 、 响 应 对 象 外 ， 错 误 处 理 中 间 件 的 参数 中 还 多 了 一 个 错误 对 象 。 

Connect 刻意 将 错误 处 理 做 到 极 简 ， 让 开发 人 员 指 明 应 该 如 何 处 理 错 误 。 比 如 说 ， 可 以 只 让 
系统 和 程序 级 错误 ( 比如 “undefined 的 变量 foo”) 通过 中 间 件 , 或 者 只 让 用 户 错误 (“ 密 码 无 效 ”) 
通过 ， 或 者 让 两 者 的 组 合 通过 。Connect 让 你 自己 选择 最 佳 的 处 理 策 略 。 

接 下 来 会 介绍 错误 处 理 中 间 件 的 工作 机 制 以 及 一 些 实用 的 模式 : 
口 用 Connect 的 默认 错误 处 理 需 ; 
口 自行 处 理 。 
我 们 先 看 看 不 进行 任何 配置 时 Connect 是 如 何 处 理 错误 的 。 
1. 用 Connect 的 默认 错误 处 理 器 
因为 函数 foo () 没 有 定义 ， 所 以 下 面 这 个 中 间 件 会 抛 出 错误 ReferenceError: 
const connect = require('connect",) 
connect () 

.use((req, res) => { 

foo () ; 


res.setHeader('Content-Type', 'text/plain'); 
res.end('hello world'); 






















































































.listen(3000) 

Connect 默认 的 处 理 是 返回 响应 状态 码 500, 响应 主体 是 文本 Internal Server Error 和 错误 的 详 
细 信 息 。 这 无 可 厚 非 , 但 在 真正 的 程序 中 , 一 般 还 会 对 这 些 错 误 做 些 特殊 处 理 ， 比 如 将 它们 发 送 
给 一 个 日 志 守护 进程 。 

2. 自行 处 理 程 序 错 误 

Connect 也 支持 用 错误 处 理 中 间 件 自行 处 理 错误 。 比 如 说 ， 为 了 在 开发 时 看 到 简单 快捷 的 
错误 报告 ， 你 可 能 想 用 JSON 格式 发 送 错误 信息 ; 而 在 生产 环境 中 ， 为 了 不 把 敏感 的 内 部 信息 
(比如 栈 跟 踪 、 文 件 名 和 行 号 等 ) 暴露 给 潜在 的 攻击 者 ,你 可 能 只 想 发 送 一 个 简单 的 服务 器 错误 
响应 。 
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错误 处 理 中 间 件 函数 必须 有 四 个 参数 : err、req、res 和 next， 如 代码 清单 6-4 所 示 ， 而 
常规 的 中 间 件 只 {有 req、 res 和 next 三 个 参数 。 下 面 这 文 个 错误 处 理 中 间 件 的 完整 代码 ( 带 服务 
何 部 分 ) 在 ch06-connect-and-express/listing6 4 中 。 


代码 清单 6-4 ”Connect 中 的 错误 处 理 中 间 件 

Const env = process.env.NODE_ENV || 'development'; a Ee 
错误 处 理 中 间 件 定 
vy 由 个 会 
function errorHandler(err, req, res, next) { 4 | 义 四 人 1 参数 
res.statusCode = 500; 


switch (env) { < 777 errorHandler 中 间 件 

case 'development': 组 件 根 据 NODE_ENV 的 
comnSsole.error ('Error:'); 值 执行 不 同 的 操作 
console.error (err);} 
res.setHeader('Content-Type', 'application/json'); 
res.end(JSON.stringify (err)); 
break; 

default: 


res.end('Server error'); 
lj 


module.exports = errorHandler; 


用 NODE_ENV 设 定 程序 的 模式 “Connect 一般 会 根据 环境 变量 NODE_ENV (process. 
env .NODE_ENV) 来 切换 不 同 服务 器 环境 (比如 生产 环境 和 开发 环境 ) 下 的 行为 。 


当 Connect 遇 到 错误 时 ， 它 会 切换 ， 只 去 调用 错误 处 理 中 间 件 ， 如 图 6-3 所 示 。 
@@ 会 所 出 错误 的 HTTP 请 求 。 























Connect application 
(does error handling) 














分 派 器 一 像 往常 一 样 把 请 求 在 
本 @ 入 向 下 信和 ， 
2 @ 出 碑 ! -outer 中 间 件 报错 了 ! 





HTTP GET request 
/bad-url 


HTTP 客 户 端 hello 中 间 件 一 @@ 中 间 件 hello 被 跳 过 去 了 ， 因 为 
(Web 浏 览 器 ) 它 不 是 错误 处 理 中 间 件 。 























错误 处 理 器 一 一 本 @@ 中 间 件 srrorHandler 得 到 了 中 间 
件 logger 创 建 的 Error， 并 能 在 
Error 的 上 下 文中 响应 请 求 。 














b> 


图 6-3 引发 了 错误 的 HTTP 请 求 在 Connect 服务 器 中 的 生命 周 共 
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假设 有 一 个 允许 用 户 登 录 到 管理 区 域 的 博客 程序 。 如 果 负 责 用 户 路 由 的 中 间 件 引发 了 一 个 错 
误 ， 则 中 间 件 blog 和 aqmin 都 会 被 跳 过 ， 因 为 它们 不 是 错误 处 理 中 间 件 ( 只 有 三 个 参数 )。 然 
后 Connect 看 到 接受 错误 参数 的 errorHandler， 就 会 调用 它 。 中 间 件 看 起 来 像 下 面 这 样 : 




















connect ( ) 
.usSe (router (require('./routes/user'))) 
use(router (require('./routes/blog'))) // 跳 过 
.use (router (require('./routes/admin'))) // 跳 过 
( 


.usSe (errorHandler); 

















基于 中 间 件 的 执行 顺序 短路 某 些 功能 是 组 织 Express 程序 的 基本 概念 。 对 Connect 有 了 基本 
的 了 解 后 ， 该 去 看 看 Express 了 。 
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Express 是 非常 流行 的 Web 框架 ， 以 前 是 在 Connect 的 基础 上 搭建 的 。 尽 管 提供 了 一 些 基本 
的 功能 ， 比 如 静态 文件 服务 、URL 路 由 和 程序 配置 等 ,但 它 依然 是 极 简 的 Web 框架 。Express 提 
供 的 结构 足以 让 我 们 把 可 重用 的 代码 组 装 起 来 ， 但 又 不 会 限制 开发 实践 。 

接 下 来 ， 我 们 要 用 Express 框架 程序 生成 高 创建 一 个 新 的 Express 程序 。 后 续 几 节 内 容 会 比 
第 3 章 更 细致 地 介绍 整个 过 程 ， 所 以 看 完 本 章 内 容 后 ， 你 应 该 可 以 用 自己 掌握 的 知识 创建 Express 
Web 程序 和 RESTful API 了 。 随 着 内 容 向 前 推进 ， 程 序 的 功能 也 会 慢 慢 增加 ， 到 最 后 变 成 一 个 完 
整 的 程序 。 


6.2.1 生成 程序 框架 


Express 对 程序 结构 不 作 要 求 ， 路 由 可 以 放 在 多 个 文件 中 ， 公 共 资 源 文件 也 可 以 放 到 任何 目 
录 下 。 最 简单 的 Express 程序 可 能 像 下 面 这样 ， 但 它 仍 然 是 一 个 功能 完备 的 HITP 服务 器 。 


代码 清单 6-5 极 简 的 Express 程序 
const express = require('express'); 
const app = express(); 









































响应 对 /的 请 求 
app.get('/', (req, res) => { 
Ye， send('Hello'); Bb 发 送 “Hello” 


] 1) 作为 响应 文本 


大 碑 兹 
app.1isten (3000); 44 | 监听 端口 3000 


express-generator 包 里 有 创建 程序 框架 的 命令 行 工 具 express (1) 。 如 果 你 刚 开始 接触 
Express， 可 以 用 它 生成 的 程序 作为 起 点 。 这 个 生成 的 程序 中 有 模板 、 公 共 资 源 文件 、 配 置 等 很 多 
东西 。 

express(1) 生 成 的 程序 框架 中 只 有 几 个 目录 和 一 些 文件 ,如 图 64 所 示 。 设计 成 这 样 的 结构 ， 
是 为 了 让 开发 者 能 在 几 秒 钟 之 内 把 Express 跑 起 来 ， 但 你 完全 可 以 决定 用 什么 样 的 程序 结构 。 
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【2 @ alex@locohost: ~/Documents/Code/nodeinaction/ch07-connect-and-express/li... 





[一 app.js 
[一 bin 

[一 ww 
[一 package.json 
[一 public 
[一 images 
| 一 javascripts 
-一 Stylesheets 

style.css 

[一 routes 
[一 index.js 
Users,.js 
— views 
[— error .jade 
| 一 index.jade 
-一 layout.jade 








7 directories，9 files 


























图 6-4 使 用 EJS 模板 的 默认 程序 框架 结构 


本 章 示 例 中 所 用 的 模板 是 EJS， 其 结构 跟 HTML 很 像 。EJS 在 HTML 文档 中 舰 入 服务 器 端 
JavaScript, 并 在 发 送 到 客户 端 之 前 执行 , 所 以 说 它 跟 PHP 、JSP (在 Java 中 用 ) 和 ERB (在 Ruby 
中 用 ) 类 似 。 第 7 章 会 详细 介绍 EJS。 

本 节 会 带 你 完成 如 下 任务 : 

口 用 npm 全 局 安装 Express; 

口 生成 程序 ; 

口 探索 生成 的 程序 ， 安 装 依赖 项 。 
下 面 开 始 吧 ! 

1. 安装 Express 的 可 执行 程序 

首先 要 用 npm 全 局 安装 express-generator: 

















$ npm install -9 express-generator 


装 好 之 后 ， 可 以 用 --help 选项 看 看 可 用 的 选项 ， 如 图 6-5 所 示 。 








【2 人 @ alex@locohost: ~/Documents/Code/nodeinaction/ch07-connect-and-express/li... 
> express --help 
Usage: express [options] [dir] 
Options: 
-h, --help output usage information 
Ys -Version output the version number 
e， ejs add ejs engine Support (defaults to jade) 
hbs add handlebars engine support 
-H，--hogan add hogan.js engine support 
-C, --CSss <engine> add stylesheet <engine> support (less|stylus 
|compass|sass) (defaults to plain css) 
--git add .gitignore 
-f, --force force on non-empty directory 











图 6-5 Express 帮助 


其 中 一 些 选 项 用 来 生成 程序 中 的 某 些 部 分 。 比 如 说 , 你 可 以 指定 模板 引擎 ,让 它 生 成 选 定 模 
板 引 擎 的 空 文件 。 同 样 ， 如 果 用 --css 指定 了 CSS 预 处 理 器 ， 它 会 生成 该 CSS 预 处 理 器 的 虚拟 
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模板 文件 。 
可 执行 程序 装 好 了 ， 接 下 来 我 们 要 生成 最 终 会 变 成 在 线 留 言 板 的 程序 框架 。 
2. 生成 程序 








用 -e (或 --ejs ) 指定 要 使 用 的 模板 引擎 是 EJS， 执 行 express -e shoutbox。 如 果 你 想 
跟 我 们 在 GitHub 库 上 的 代码 保持 一 致 ， 那 就 执行 express -e listing6_6。 

一 个 功能 完备 的 程序 会 出 现在 shoutbox 目录 中 。 其 中 会 有 描述 项 目 和 依赖 项 的 packagejson 
文件 、 程 序 主 文件 、public 目录 ， 以 及 一 个 放 路 由 处 理 需 的 目录 。 

3. 探索 程序 

仔细 看 一 下 它 生成 了 什么 。 在 编辑 器 中 打开 package.json 文件 , 看 看 程序 的 依赖 项 ， 如 图 6-6 
所 示 。Express 猜 不 出 你 要 用 依赖 项 的 哪个 版 本 ， 所 以 你 最 好 给 出 模块 的 主要 、 次 要 及 修订 版 本 
号 ， 以 免 引 起 意 想不到 的 bug。 比 如 明确 给 出 "express":"~4.13.1"， 那么 npm 每 次 都 会 安装 
相同 的 代码 。 














1 1 

2 "name": "listing6_6", 

3 "version": "6.0.0", 

4 "private": true, 

5 "scripts": { 

6 "start": "node ./bin/www" 
7 }, 

8 "dependencies": { 

9 "body-parser": "~1.13.2", 
16 "cookie-parser": "~1.3.5", 
了 "debug": "~2.2.9"， 

12 "express": "~4.13.1", 

13 "pug™s “1 Bu@s 

14 "morgan": "~1.6.1", 

15 "serve-favicon": "~2.3.0" 
16 } 

7 














图 6-6 生成 的 package.json 


现在 看 一 下 express (1) 生 成 的 程序 主 文件 ， 如 下 面 的 代码 清单 所 示 。 暂 时 先 不 要 动 它 。 其 
中 有 前 面 介绍 过 的 中 间 件 ， 但 默认 的 中 间 件 配置 什么 样 还 是 值得 一 看 的 。 


代码 清单 6-6 ”生成 的 Express 程序 框架 




















var express = require('express'); 

Var path = require('path'); 

Var favicon = require('serve-favicon'); 二 | 提供 默认 的 
Var logger = require('morgan'); favicon 


Var cookieParser = require('cookie-parser'); 
Var bodyParser = require('body-parser'); 

Var routes = require('./routes/index'); 

Var users = require('./routes/users'); 

Var app = express(); 


app.set('views', path.join(_ dirname, 'views')); 
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app.set('view engine', 'ejs'); 


输出 有 颜色 区 分 的 日 志 ， 
以 便于 开发 调试 
全 三 | 





app.use(logger('dev')); 
app.use (bodyParser.json()); < FF、 去 -人 阿 
app.use (boqyParser.urlencodedq({ extended: false }) ) 解析 请 求 主体 
app.use (cookieParser ()); 

( 


app.use (express.static(path.join(_ dirname, 'public'))); 了 一] 提供 ./public 下 
的 静态 文件 
app.use('/', routes); < 一 一 
app.use('/users', users); 指定 程序 
路 由 


app.use (function(req, res, next) { 
let err = new Error('Not Found'); 
err.status = 404; 


’ 


next (err); 
} 
if (app.get('env') === 'development') { 4 1 在 开发 时 显示 样式 化 
app.use (function(err, req, res, next) { i 的 HTML 错误 页 面 
res.status(err.status || 500); 
res.render('error', { 


message: err.message, 
EE. :OEE 


app.use (function(err, req, res, next) { 
res.status(err.status || 500); 
res.render('error', { 
message: err.message, 
error: {} 
Fy 
国友 


module.exports = app; 


虽然 有 了 packagejson 和 appjs 文件, 但 程序 还 跑 不 起 来 ， 因 为 依赖 项 还 没 装 。 不管 express (1) 
什么 时 候 生 成 package.json， 都 要 安装 依赖 项 。 执 行 npm install， 然 后 执行 npm start 启 
动 程序 。 

在 浏览 器 中 访问 http:Vlocalhost:3000 ， 默 认 程 序 看 起 来 如 图 6-7 所 示 。 




















Express ~ Mozilla Firefox 
© | Express 二 


《 localhost:3000 


Express 


Welcome to Express 














图 6-7 默认 的 Express 程序 
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看 过 了 生成 的 程序 框架 ， 可 以 开始 搭建 真正 的 Express 程序 了 。 我 们 要 做 一 个 允许 用 户 发 消 
息 的 在 线 留言 板 。 在 做 这 样 的 程序 时 ， 大 多 数 有 经 验 的 Express 开发 人 员 都 会 从 规划 API 开始 ， 
然后 由 此 推导 出 所 需 的 路 由 和 资源 。 
4. 在 线 留言 板 程序 的 规划 
下 面 是 这 个 在 线 留言 板 程 序 的 需求 。 
(1) 用 户 应 该 可 以 注册 、 登 录 、 退 出 。 
(2) 用 户 应 该 可 以 发 消息 (条目 )。 
(3) 站 点 的 访问 者 可 以 分 页 浏览 条 目 。 
(4) 应 该 有 个 支持 认证 的 简单 的 REST API。 
针对 这 些 需求 ,我 们 要 存储 数据 和 处 理 用 户 认证 ,还 需要 对 用 户 的 输入 进行 校 验 。 必 要 的 路 
由 应 该 有 以 下 两 种 。 
口 API 路 由 。 
@ GET /api/entries: 获取 条 目 列 表 。 
和 GET /api/entries/page: 获取 单 页 条 目 。 
昌 POST /api/entry: 创建 新 的 留言 条 目 。 
口 Web UI 路 由 。 
@ GET /post: 显示 创建 新 条 目的 表单 。 
昌 POST /post: 提交 新 条 目 。 
和 GET /register: 显示 注册 表单 。 
曙 POST /register: 创建 新 的 用 户 账号 。 
四 GET /login: 显示 登录 表单 。 
曙 POST /login: 登录 。 
和 GET /logout: 退出 。 
这 个 布局 跟 大 多 数 Web 程序 一 样 。 希 望 将 来 你 能 以 此 为 模板 搭建 自己 的 程序 。 
你 可 能 已 经 注意 到 上 一 个 代码 清单 中 的 app. set 了 : 


app.set ('views', path.join( dirname, 'views')); 
app.set('view engine', 'ejs'); 


这 就 是 Express 程序 的 配置 方式 ， 接 下 来 我 们 要 详细 讲解 Express 的 配置 。 










































































6.2.2 Express 和 程序 的 配置 


程序 运行 的 环境 发 生变 化 时 ， 需 求 也 会 发 生变 化 。 比 如 说 , 产品 在 开发 环境 中 运行 时 ， 你 可 
能 想 要 看 到 尽 可 能 详尽 的 日 志 ; 但 在 生产 环境 中 ， 你 可 能 想 让 日 志 尽量 精简 ， 可 能 还 要 用 gzip 
进行 压缩 。 除 了 配置 特定 环境 下 的 功能 ， 还 要 定义 一 些 程序 层面 的 配置 项 ， 以 便 让 Express 知道 
你 用 的 是 什么 模板 引擎 ， 到 哪里 去 找 模板 。Express 还 支持 自 定义 的 配置 项 键 / 值 对 。 
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设置 环境 变量 
要 在 UNIX 系统 中 设置 环境 变量 ， 可 以 用 这 个 命令 : 
$ NODE_ENV=production node app 
在 Windows 中 用 这 个 : 


SNoDeoen roe ne 
$ node app 


这 些 环境 变量 会 出 现在 程序 里 的 process.env 对 象 中 。 














Express 有 一 个 极 简 的 环境 驱动 配置 系统 ， 这 个 系统 由 儿 个 方法 组 成 ， 全 部 由 环境 变量 
NODE_ENV 驱动 : 


























DQ app.set() 
D app.get () 
D app.enable() 
D app.disable() 
口 app.enabled() 
D app.disabled() 
在 本 节 中 ， 你 将 会 看 到 如 何 用 配置 系统 定制 Express 的 行为 ， 以 及 在 开发 时 如 何 让 它 如 你 
所 愿 。 
我 们 先 来 探讨 一 下 基于 环境 的 配置 是 什么 意思 。 环 境 变 量 NODE_ENV 源 于 Express， 后 来 很 
多 Node 框架 照搬 了 这 一 做 法 ， 用 它 告 知 Node 程序 运行 在 哪个 环境 中 ， 其 默认 是 开发 环境 。 
app.configure () 方 法 有 一 个 可 选 的 字符 串 参 数 ， 用 来 指定 运行 环境 ;还 有 一 个 参数 是 函 
数 。 如 果 有 这 个 字符 串 ， 则 在 运行 环境 与 字符 串 相 同时 才 会 调用 那个 函数 ; 如 果 没 有 ， 则 在 所 有 
环境 中 都 会 调用 那个 函数 。 这 些 环境 的 名 称 完 全 是 随意 的 。 比 如 说 ， 可 以 用 development、 
stage、 test 和 production, 或 简写 为 prod: 



















































































if (app.get('env') === 'development') { 
app.use (express.errorHandler ()); 


} 


为 了 实现 可 定制 的 行为 ，Express 在 其 内 部 使 用 了 配置 系统 ， 我 们 也 可 以 在 自己 的 程序 中 使 
用 这 个 系统 。 

Express 还 为 布尔 类 型 的 配置 项 提供 了 app.set () 和 app.get () 的 变 体 。 比 如 说 ，app.enable 
(setting) 等 同 于 app.set (setting, true), 而 app.enabled (setting) 可 以 用 来 检查 该 
值 是 否 被 启用 了 。app.disable (setting) 和 app.disabled(setting) 是 对 它们 的 补充 。 

Express 为 开发 API 提供 了 一 个 配置 项 ， 即 json spaces。 如 果 把 它 加 到 app.js 中 ， 程 序 输 
出 JSON 的 格式 会 变 得 更 易 读 : 






































app.set('json spaces', 2); 


介绍 完 如 何 使 用 配置 系统 ， 接 下 来 该 讲 讲 Express 中 的 视图 泻 染 了 。 
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6.2.3 ” 泻 染 视图 


尽管 前 面 说 过 ，Express 几乎 支持 所 有 Node 社 区 中 的 模板 引擎 , 但 本 章 的 程序 用 的 是 EJS 模 
板 。 不 熟悉 EJS 也 不 用 担心 ， 它 很 像 其 他 Web 开发 平台 (PHP、JSP、ERB ) 中 的 模板 语言 。 本 
章 只 会 涉及 EJS 的 一 些 基础 知识 ， 但 第 7 章 会 详细 介绍 EJS 和 其 他 几 个 模板 引擎 。 

不 管 是 泻 染 整 个 HTML 页 面 、 一 个 HTML 片段 ,还 是 一 个 RSS 预订 源 ， 对 几乎 所 有 程序 来 
说 ， 视 图 泻 染 都 非常 重要 。 其 概念 很 简单 : 把 数据 传 给 视图 ， 然后 视图 对 数据 进行 转换 ， 对 Web 
程序 来 说 , 通常 是 转换 成 HTML。 你 对 视图 应 该 不 会 觉得 陌生 , 因为 大 多 数 框架 都 有 类 似 的 功能 。 
图 6-8 前 明了 视图 如 何 形成 新 的 数据 表示 。 
























































{ name: 'Tobi', species: 'ferret', age: 2 } 


<h1>Tobi</h1> 
<p>Tobi is a 2 year old ferret.</p> 











图 6-8 HTML 模板 + 数据 = 数据 的 HIML 视图 
6-8 对 应 的 模板 如 下 所 示 : 


<h1l><%$= name %></hi1> 
<p><%= name %> is a 2 year old <%= species %>.</p> 


Express 中 有 两 种 泻 染 视图 的 办 法 : 程序 层面 用 app .render ()， 在 请 求 或 响应 层面 用 
res.render() ，Express 内 部 用 的 是 前 一 种 。 本 章 只 用 res.render() 。 如 果 你 看 一 
下 .Houtes/index.js， 会 看 到 一 个 调用 res .render ('index') 的 函数 ， 演 染 的 是 ./views/index.ejs 
模板 ， 代 码 如 下 所 示 ( 参见 listing6_8 ): 

router.get ("/" (keds;. Tes, ext) “=> 


res.render('index', { title: 'Express' }); 
区 


在 研究 res .render () 之 前 ， 先 来 看 看 如 何 配 置 视图 系统 。 
1. 配置 视图 系统 
Express 视图 系统 的 配置 很 简单 。 即 便 express (1) 已 经 生成 好 了 ， 你 还 是 应 该 了 解 一 下 这 
些 配置 的 底层 机 制 ， 以 便 在 需要 时 进行 修改 。 我 们 会 重点 介绍 三 个 领域 
口 调整 视图 的 查找 ; 
口 配置 默认 的 模板 引擎 ; 
口 启用 视图 缓存 ， 减 少 文件 TO。 


首先 是 设 定 views。 
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@ 改变 查找 目录 
下 面 的 代码 片段 是 Express 的 可 执行 程序 创建 的 views 设 定 : 
app.set('views', _ dirname + '/views'); 








这 个 配置 项 指明 了 Express 查找 视图 的 目录 。 这 里 的 __qdirname 用 得 好 , 这 样 程序 就 不 用 把 当前 
工作 目录 当 作 程序 根 目录 了 。 














dirname 


Node 中 的 ” ”dirname (前面 有 两 个 下 划 线 ) 是 个 全 局 变量 ,表示 当前 运行 的 文件 所 在 的 
目录 。 在 开发 时 ， 这 个 目录 通常 就 是 当前 工作 目录 ( CWD ), 但 在 生产 环境 中 ， 这 个 文件 可 能 
运行 在 其 他 目录 中 。 dirname 有 助 于 保持 路 径 在 各 种 环境 中 的 一 致 性 。 

















下 一 个 配置 项 是 view engine。 
@ 使 用 默认 的 模板 引擎 
用 express (1) 生 成 程序 时 ， 我 们 在 命令 行 中 用 -e 指定 模板 引擎 EJS， 所 以 view engine 
被 设 为 ejs。Express 要 靠 扩展 名 确定 用 哪个 模板 引擎 泻 染 文件 ， 但 有 了 这 个 配置 项 ， 我 们 可 以 
用 indaex 指定 要 泻 染 的 文件 ， 而 不 需要 用 inqex.ejs。 
你 可 能 会 想 ，Express 为 什么 还 要 考虑 扩展 名 。 因 为 如 果 使 用 带 扩 展 名 的 模板 文件 ， 就 可 以 
在 同一 个 Express 程序 中 使 用 多 个 模板 引擎 。 同 时 这 样 又 能 提供 一 个 清晰 的 API， 因 为 大 多 数 程 
序 都 是 只 用 一 个 模板 引擎 。 
比如 说 ， 你 发 现 用 另 一 种 模板 引擎 写 RSS 预订 源 更 容易 ， 或 者 正 要 换 一 个 模板 引 警 用。 你 
可 能 将 Pug 作为 默认 引擎 ， 用 EJS 演 染 /feed 路 由 的 响应 结果 ， 就 像 下 面 的 代码 一 样 指 明 .ejs 扩 
展 名 oO 
app.set('view engine', 'pug'); 
app.get('/', function()f{ 
res.render('index'); 
二 
app.get ('/feed', function(){ 


res.render('rss.ejs'); 


有 






































保持 packagejson 同步 ” 记 住 ， 所 有 要 用 到 的 模板 引擎 都 应 该 添加 到 package.json 的 
依赖 项 对 象 中 。 用 npm install --save package-name 安装 ， 用 npm uninstall -- 
save package-name 从 node modules 和 package.json 中 删除 。 在 你 还 不 知道 该 用 哪个 
模板 引擎 时 ， 你 的 试验 会 轻松 一 些 。 

2. 视图 缓存 
在 生产 环境 中 ，view cache 是 默认 开启 的 ， 以 防止 后 续 的 rengder () 从 硬盘 中 读 取 模板 文 
件 。 因 为 模板 文件 中 的 内 容 会 被 放 到 内 存 中 ， 所 以 性 能 会 得 到 显著 提升 。 但 启用 这 个 配置 项 后 ， 
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只 有 重启 服务 咒 才 能 让 模板 文件 的 编辑 生效 ， 所 以 在 开发 时 会 禁用 它 。 如 果 在 分 级 ( staging ) 环 
境 中 和 运行， 很 可 能 要 局 用 这 个 配置 项 。 
如 图 6-9 所 示 ，view cache 被 禁用 时 ， 每 次 请 求 都 会 从 硬盘 上 读 取 模板 。 这 样 无 须 重 启程 
序 来 让 模板 的 修改 生效 。 启 用 view cache 后 ， 每 个 模板 只 需要 读 取 一 次 硬盘 。 
你 已 经 知道 视图 缓存 机 制 是 如 何 提升 非 开发 环境 中 的 程序 性 能 了 。 接 下 来 我 们 看 看 Express 
如 何 定位 视图 来 泻 染 它们 。 
请 求 禁用 缓存 




























res.render('user', {name: 'Tobi'}) 









































EE 
me 
2 res.render('user', {name: 'Tobi'}) 
响应 
请 求 启用 缓存 
请 求 
1 res.render('user', {name: 'Tobi'}) 
响应 
请 求 “上 
2 res.render('user', {name: 'Tobi'}) 
响应 ng 











图 6-9 ”视图 缓存 设置 


3. 视图 查找 

查找 视图 的 过 程 跟 require () 查找 模块 的 过 程 差不多 。 在 程序 中 调用 了 res .render () 或 
app.render() 后 ，Express 会 先 检查 有 没有 这 样 的 绝对 路 径 ， 接 着 找 视 图 目录 的 相对 路 径 。 最 
后 会 尝试 找 目 录 中 的 index 文件 。 整 个 过 程 如 图 6-10 所 示 。 
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| 视图 泻 染 请 求 





| 是 绝对 路 径 上 的 文件 吗 ? 





是 

















是 相对 于 配置 项 “views” 指 
定 的 目录 下 的 文件 吗 ? 


不 是 





用 这 个 文件 处 理 视图 


存在 








index 文 件 存在 吗 ? 





于 





不 存在 








返回 错误 





图 6-10 Express 视图 查找 过 程 


因为 ejs 被 设 为 默认 引擎 ， 所 以 无 须 在 render 中 指明 模板 文件 的 扩展 名 .ejs。 

随 着 开发 进展 , 程序 中 的 视图 会 越 来 越 多 , 并且 有 时 一 个 资源 会 有 几 个 视图 。view lookup 
可 以 帮 我 们 组 织 这 些 视图 ， 比 如 说 把 视图 文件 放 在 跟 资源 相连 的 子 目录 中 。 

用 添加 子 目录 的 办 法 可 以 去 掉 模 板 文件 名 称 中 的 见 余 部 分 ， 比 如 edit-entry.ejs 和 show-entry.ejs。 
Express 会 添加 跟 view engine 匹配 的 扩展 名 ,根据 res.render ('entries/edit') 定 位 
到 /views/entries/edit.ejs。 

Express 会 检查 views 的 子 上 日 录 中 是 否 有 名 为 index 的 文件 。 当 文件 的 名 称 为 复数 时 ， 比 如 entries， 
通常 表示 这 是 一 个 资源 列表 。 也 就 是 说 res .render ('entries') 一 般 会 泻 染 文件 views/entries/ 
index.ejs。 

4. 将 数据 传递 给 视图 的 办 法 

在 Express 中 ， 要 给 被 泻 染 的 视图 传递 数据 有 几 种 办 法 ， 其 中 最 常用 的 是 将 要 传递 的 数据 作 
为 res.renqer () 的 参数 。 此 外 ， 还 可 以 在 路 由 处 理 器 之 前 的 中 间 件 中 设 定 一 些 变量 ， 比 如 用 
app .locals 传递 程序 层面 的 数据 ,用 res. locals 传递 请 求 层面 的 数据 。 

将 变量 直接 作为 res.render () 的 参数 优先 级 最 高 ， 要 高 于 在 res.locals 和 app.locals 
中 设 定 的 变量 值 ， 如 图 6-11 所 示 。 
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| 在 模板 中 发 现 变量 
了 和 
有 
renger 中 有 传人 的 值 吗 ? 
4 
没有 返回 值 | 

没有 

J 
没有 
返回 错误 




















图 6-11 演 染 模板 时 ， 直 接 传 给 renger 函数 的 值 优先 级 最 高 
默认 情况 下 ，Express 只 会 向 视图 中 传递 一 个 程序 级 变量 settings， 这 个 对 象 中 包含 所 





























有 用 app.set 1() 设 定 的 值 。 比 如 app.set ('title', 'My Application') 会 把 settings. 
title 输出 到 模板 中 ， 请 看 下 面 的 EJS 代码 片段 : 
<html> 
<head> 
<title><%$= settings.title %></title> 
</head> 
<body> 


<hl><%= settings.title %></hl> 
<p>Welcome to <%= settings.title %$>.</p> 
</body> 


实际 上 ，Express 是 像 下 面 这 样 输 出 这 个 对 象 的 : 

app.locals.settings = app.settings; 

这 就 是 关于 数据 传递 的 全 部 知识 ! 在 了 解 了 如 何 泻 染 视图 以 及 如 何 传递 数据 给 它们 之 后 , 该 
去 看 看 怎么 给 我 们 的 在 线 留言 板 程序 定义 路 由 和 路 由 处 理 器 了 。 另外 还 要 创建 数据 库 模型 来 做 数 
据 的 持久 化 。 


























6.2.4 “Express 路 由 入 门 


Express 路 由 的 主要 任务 是 将 特定 模式 的 URL 匹配 到 响应 逻辑 上 。 但 也 可 以 将 URL 模式 匹 
配 到 中 间 件 上 ， 以 便 用 中 间 件 实现 某 些 路 由 上 的 可 重用 功能 。 
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本 节 要 : 
口 用 特定 路 由 的 中 间 件 校 验 用 户 提 交 的 内 容 ; 
口 实现 特定 路 由 的 校 验 。 

先 看 看 特定 路 由 中 间 件 有 哪些 用 法 。 

1. 校 验 用 户 内 容 提交 

为 了 介绍 校 验 的 做 法 ， 我 们 要 给 这 个 程序 加 上 消息 提交 功能 。 实现 这 个 功能 需要 完成 下 面 
几 项 工作 : 
口 创建 消息 模型 ; 
口 添加 与 消息 相关 的 路 由 ; 
口 创建 消息 表单 ; 
口 添加 业务 逻辑 ， 用 提交 上 来 的 表单 数据 创建 消息 。 

下 面 先 来 创建 消息 模型 。 

@ 创建 消息 模型 

在 创建 模型 之 前 ， 需 要 先 安装 Node redis 模块 。 执 行 命令 npm install --save redis。 
如 果 你 的 机 器 上 没 装 Redis， 请 访问 其 官网 了 解 如 何 安装 ; 如 果 你 用 的 是 macOS， 可 以 用 Homebrew 
安装 ，Windows 有 Redis Chocolatey 包 。 

这 里 用 Redis 是 想 偷 点 儿 懒 : 借助 Redis 和 ES6 的 特性 ， 我 们 不 需要 用 复杂 的 数据 库 就 能 轻 
松 创 建 出 轻便 的 模型 。 如 果 你 想 自 己 试 试 其 他 的 数据 库 ， 可 以 参考 第 8 章 介绍 的 知识 。 

接 下 来 可 以 看 看 如 何 创建 保存 在 线 留言 板 消 息 条 目的 模型 了 。 创 建 models/entryjs 文件 ， 将 
下 面 的 代码 放 到 这 个 文件 中 。 这 是 个 简单 的 ES6 类 ， 它 会 把 数据 存 到 Redis 列表 中 。 














































































































代码 清单 6-7 消息 条 目 模型 


const redis = require('redis'); 
const db = redis.createClient (); 创建 Redis 客 
汪汪 作 | 
class Entry { 户 端 实例 
constructor(obj) { 
TO 循环 遍历 传 入 
ER 对 象 中 的 键 
合并 值 } 
3 
save(cb) { 将 保存 的 消息 转换 
const entryJSON = JSON.stringify (this); 成 JSON 字符 串 
db.lpush( SE 
a 将 JSON 字符 串 保 
| 存 到 Redis 列表 中 


>" 捞 
if (err) return cbl(err); 
eb.(Ys; 
} 
) 3 
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} 
module.exports = Entry; 
基本 模型 有 了 , 现在 要 添加 获取 消息 用 的 getRange 函数 , 代码 如 下 所 示 。 你 可 以 用 这 个 函 
数 获取 消息 。 
代码 清单 6-8 ”获取 一 部 分 消息 的 逻辑 


jass. Bitrey 
static getRange (from, to, cb) { 


db.lrange('entries', from, to, (err, items) => { < 一 一 用 来 获取 消息 记录 的 
/日 和 村 多 
if (err) return cbl(err); Redis lrange 函数 


let entries = []; 
items.forEach((item) => { 
entries.push(JSON.parse (item)); 人 一 解码 之 前 保存 为 JSON 


}); 的 消息 记录 


cb(null, entries); 
} 


} 
创建 好 模型 ， 现 在 你 可 以 添加 路 由 来 创建 消息 和 获取 消息 列表 了 。 

@ 创建 消息 表单 

接 下 来 添加 创建 消息 的 功能 ， 先 把 下 面 的 代码 添加 到 appJjs 的 路 由 部 分 : 


app.get ('/post', entries.form); 
app.post('/post', entries.submit); 


接着 把 下 面 的 代码 添加 到 routes/entries.js 中 。 这 个 路 由 逻辑 会 泻 染 一 个 包含 表单 的 模板 ; 








exports.form = (req, res) => { 
res.render('post', { title: 'Post' }); 
这 


然后 用 下 面 的 EJS 代码 创建 表单 模板 views/post.ejs。 
代码 清单 6-9 用 于 输入 消息 数据 的 表单 


<!DOCTYPE html> 
<html> 
<head> 
<title><%= title %$></title> 
<link rel='stylesheet' href='/stylesheets/style.css' /> 
</head> 
<body> 
< 多 include menu %> 
<hl><%= title %></hl> 


<p>Fill in the form below to add a new post.</p> , 
: 消息 标题 
<form action='/post' method='post'> 人 
<pB> 
<input type='text' name='entry [titlel' placeholder='Title' /> < 


</p> 





A 
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发 他 六 
<textarea name='entry [boqy] 

</p> 

<p> 
<input type='submit' 

</p> 

</form> 
</body> 
</html> 


value='Post' /> 


placeholder='Body'></textarea> 


< | 


消息 主体 


这 个 表单 用 了 形 如 entzry[title] 之 类 的 输入 控件 名 称 ， 需 要 用 扩展 的 消息 体 解 析 器 来 解 


析 。 打 开 app.js， 找 到 
app.use(bodqyParser.urlencodqed({ extended: 
改 成 : 


app.use(bodqyParser.urlencodqed({ extended: 


false })); 


te) 2 


显示 表单 的 页 面 做 好 了 ， 接 下 来 我 们 要 用 表单 提交 上 来 的 数据 创建 消息 。 


@ 实现 消息 的 创建 


把 下 面 的 代码 添加 到 文件 routes/entries.js 中 ， 实 现 用 表单 提交 上 来 的 数据 创建 消 


代码 清单 6-10 ”用 表单 提交 的 数据 创建 消息 


exports.submit = (req, res, next) => 
const data = reqgq.body.entry; < 的 控件 
const user = res.locals.user; 
const username = user ? user.name : null; 
const entry = new Entry(t{ 
username: username, 
title: data.title, 


body: data.body 
}) 3 
entry.save((err) => { 
if (err) return next (err); 
res.redirect ('/'); 
})3 
} 四 





处 理 好 消息 创建 的 功能 ， 该 实现 泻 染 消息 列表 的 功能 
@ 添加 显示 消息 的 首页 





先 创建 routes/entriesjs， 然 后 把 下 面 的 代码 放 到 里 面 。 引 入 消 ， 
代码 清单 6-11 消息 列表 
const Entry = require('../models/entry'); 本 
exports.list = (req, res, next) => { 获取 
Entry.getRange(0, -1, (err, entries) => { 二 | 消息 





息 模 


来 自 表 单 中 名 为 “entry[...]” 


自 


/VOD 





加 载 用 户 数据 的 中 间 件 
在 代码 清单 6-28 中 








型 ， 输 出 泻 


现在 用 浏览 器 访问 /post 后 应 该 可 以 添加 消息 了 。 到 代码 清单 6-21 时 才 会 要 求 用 户 先 登录 。 


染 消 息 列表 的 
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if (err) return next (err); 
res.render('entries', { < 一 一 
title: 'Entries', 泻 染 HTTP 响应 
entries: entries, 
} 
es 
过 


这 个 路 由 的 业务 逻辑 定义 好 之 后 ,还 需要 添加 EJS 模板 来 显示 这 些 消 息 。 在 views 目录 下 创 
建 entries.ejs 文件 ， 并 加 入 下 面 的 EJS 代码 。 


代码 清单 6-12 ”视图 entries.ejs 
<!DOCTYPE html> 
<html> 
<head> 
<title><%= title %$></title> 
<link rel='stylesheet' href='/stylesheets/style.css' /> 
</head> 
<body> 
< 多 include menu %> 
<%$ entries.forEach( (entry) => { %> 
<div class='entry'> 
<h3><%= entry.title %$></h3> 
<p><%$= entry.body %$></p> 
<p>Posted by <%= entry.username %></p> 
</div> 











< 
</body> 

</html> 

在 运行 程序 之 前 , 先 用 touch views /menu .ejs 创建 菜单 模板 文件 , 后 面 再 添加 具体 代码 。 
图 和 路 由 准备 好 后 ， 需 要 告诉 程序 到 哪里 去 找 这 些 路 由 。 

@ 添加 与 消息 相关 的 路 由 

在 把 与 消息 相关 的 路 由 添加 到 程序 中 之 前 ， 需 要 调整 一 下 appjs。 先 把 下 面 这 个 require 
语句 放 在 appJjs 文件 的 顶端 : 


const entries = require('./routes/entries'); 


接 下 来 , 还 是 在 app.js 中 ,修改 包含 app .get ('/' 的 那 行 代码 ， 改 成 下 面 这 样 ， 让 发 给 /的 
请 求 返 回 消息 列表 : 

app.get ('/', entries.list); 

现在 运行 这 个 程序 ,首页 会 显示 消息 列表 。 既 然 消 息 创建 和 显示 列表 都 做 好 了 , 那么 接 下 来 
该 看 看 如 何 用 特定 路 由 中 间 件 校 验 表单 数据 了 。 

@ 使 用 特定 路 由 中 间 件 

假定 你 想 将 表单 中 的 消息 文本 域 设 为 必 填 项 。 能 想到 的 第 一 种 方式 可 能 是 像 下 面 的 代码 那 
样 把 它 直 接 加 在 路 由 回调 函数 中 。 然 而 这 种 方式 并 不 理想 ， 因 为 校 验 逻 辑 是 绑 死 在 这 个 表单 上 
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的 。 而 在 大 多 数 情况 下 ， 校 验 逻 辑 都 能 被 提炼 到 可 重用 的 组 件 中 ， 让 开发 更 容易 、 更 快 、 更 具 
声明 性 : 





exports.submit = (req, res, next) => { 

let data = regqg.body.entry; 

if (!data.title) { 
res.error('Title is required.'); 
res.redirect ('back'); 
return; 

} 

if (data.title.length < 4) { 
res.error('Title must be longer than 4 characters.'); 
res.redirect ('back'); 
return; 


} 








Express 路 由 可 以 有 自己 的 中 间 件 ， 其 被 放 在 路 由 回调 函数 之 前 ， 只 有 跟 这 个 路 由 匹配 时 才 
会 调用 。 本 章 所 用 的 路 由 回调 并 没有 做 特殊 处 理 。 这 些 中 间 件 跟 其 他 中 间 件 一 样 ， 甚 至 你 即将 创 
建 的 校 验 中 间 件 也 一 样 。 

接 下 来 我 们 要 用 特定 路 由 中 间 件 来 做 校 验 ， 先 来 看 一 种 虽然 简单 但 不 太 灵 活 的 实现 方式 。 

2. 用 特定 路 由 中 间 件 实现 表单 校 验 

第 一 种 方式 是 写 几 个 简单 但 特定 的 中 间 件 组 件 来 执行 校 验 。 带 有 此 类 中 间 件 的 PosT/post 
看 起 来 应 该 像 下 面 这 样 : 


app.post('/post', 
requireEntryTitle, 
requireEntryTitleLengthAbove (4) ， 
entries.submit 


) . 


一 般 的 路 由 定义 只 有 两 个 参数 : 路 径 和 路 由 处 理 函 数 , 而 这 个 路 由 定义 中 又 额外 地 增加 了 两 
个 参数 ， 这 两 个 参数 就 是 校 验 中 间 件 。 

在 下 面 的 代码 中 , 我 们 把 原来 的 校 验 逻 辑 剥 离 出 来 做 成 了 两 个 中 间 件 。 但 它们 的 模块 化 程度 
还 不 高 ， 只 能 用 在 输入 域 entry [title] 上 。 


代码 清单 6-13 ”两 个 更 有 潜力 但 仍 不 完美 的 校 验 中 间 件 
function requireEntryTitle(req, res, next) { 
const title = regq.body.entry.title; 
if (title) { 
next (); 
} else { 
res.error('Title is required.'); 
res.redirect ('back'); 
} 
} 
function requireEntryTitleLengthAbove(len) { 
return (reqgq, res, next) => { 
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const title = req.body.entry.title; 
if (title.length > len) { 
next (); 
else { 
res.error(‘Title must be longer than S${len}..); 
res.redirect ('back'); 
} 

3 

} 


实际 工作 中 更 常用 的 方案 是 进一步 抽象 , 剥离 成 更 灵活 的 校 验 器 , 以 目标 输入 域 的 名 称 为 参 
数 进 行 校 验 。 下 面 来 看 一 下 这 种 实现 方式 。 

@ 构建 灵活 的 校 验 中 间 件 

如 果 能 重用 校 验 逻 辑 ， 可 以 像 下 面 这 样 传人 输入 域名 称 ， 那 我 们 的 工作 量 会 进一步 降低 。 


app.post('/post', 
validate.required('entryl[ltitle]'), 
validate.lengthAbove('entryl[ltitle]', 4), 
entries.submit); 


打开 app.js， 把 路 由 部 分 的 app .post ('/post'，entries.submit); 换 成 上 面 这 段 代码 。 

这 里 有 必要 提 一 下 ，Express 社区 已 经 创建 了 很 多 类 似 的 公用 库 ， 但 掌握 校 验 中 间 件 的 工作 机 制 

以 及 如 何 编写 中 间 件 仍然 很 有 必要 。 6 
开始 动手 写 代 码 吧 。 用 代码 清单 6-14 中 的 代码 创建 .middleware/validate.js 文件 。validate.js 

会 输出 valigdate.required() 和 validate.lengthAbove() 两 个 中 间 件 。 这 里 的 实现 细节 并 

不 重要 ， 关 键 是 通过 这 个 例子 学 习 如 何 提炼 出 程序 中 的 通用 代码 ， 用 少量 的 工作 成 果 发 挥 大 作用 。 


代码 清单 6-14 ” 校 验 中 间 件 的 实现 
function parseField(field) { < 一 一 
return field | 解析 entry [name] 符 号 
‘SDLLE(CANLL NY 
.filter((s) => s); 
} 基于 parseField() 
function getFieldl(req, field) { 了 一 | 的 结果 查找 属性 
let val = req.body; 
field.forEach( (prop) => { 
val = vall[lprop]; 
Ee 


return val; 


= 
































} 解析 输入 
exports.required = (field) => { 域 一 次 
field = parseField (field); < 一 每 次 收 到 请 求 都 检 
return (req, res, next) => { | 吉 失 入 晤 是 有 从 
if (getField(req, field)) { < 一 


_ 


next (); 如 果 有 , 则 进 
else { 入 下 一 个 中 
res.ertror( sffield.join(' ')} is required ); 二 间 件 


res.redqirect ('back'); 
如 果 没有 ， 


显示 错误 
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和 
人 
exports.lengthAbove 
field = parseField (field); 


= (field, len) => { 
( 
return (req, res, next) => { 


if (getField(req, field) .length > len) { 
next (); 
} else { 


const fields = field.join(' '); 
res.error(“s$s{fields} must have more than S${len} characters ~ )，; 
res.redirect ('back'); 
} 
于 
} 四 


为 了 让 程序 能 访问 到 这 个 中 间 件 ， 需 要 把 下 面 这 行 代码 放 到 app.js 中 : 
const validate = require('./middleware/validate'); 


现在 再 试 , 应 该 发 现 校 验 已 经 生效 了 。 这 个 校 验 API 还 可 以 进一步 优化 , 你 可 以 
练习 自己 研究 一 下 。 


























这 个 当 作 


[二 


6.2.5 ”用户 认证 


本 节 会 带 你 从 头 开 始 为 我 们 的 程序 创建 一 个 认证 系统 。 你 要 实现 下 面 这 些 功能 : 
口 存储 和 认证 已 注册 用 户 ; 
口 注册 功能 ; 
D 登录 功能 ; 
口 加 载 用 户 信息 的 中 间 件 。 
我 们 还 是 用 Redis 作为 用 户 账号 的 存储 。 接 下 来 先 创建 User 模 型 ， 看 看 如 何 让 Redis 用 起 来 
更 容易 。 
1. 保存 和 加 载 用 户 记 录 
本 节 要 实现 用 户 加 载 、 保 存 和 认证 。 任 务 清单 是 : 
口 用 package.json 定义 程序 的 依赖 项 ; 
口 创建 用 户 模型 ; 
口 用 Redis 加 载 和 保存 用 户 信息 ; 
口 用 bcrypt 增 强 用 户 密 码 的 安全 性 ; 
口 实现 用 户 认证 。 
Becrypt 是 一 个 加 盐 的 哈 希 函数 ， 可 作为 第 三 方 模块 专门 对 密码 做 哈 希 处 理 。Bcrypt 特别 适合 
处 理 密码 ， 因 为 计算 机 越 来 越 快 ， 而 bcrypt 能 让 破解 变 慢 ， 从 而 有 效 对 抗暴 力 攻击 。 
先 用 npm install --save redis bcrypt 安装 这 些 依赖 项 。 
2. 创建 用 户 模型 
在 models/ 目录 下 创建 userjs。 
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代码 清单 6-15 中 是 用 户 模 型 的 代码 。 这 段 代 码 引 入 了 依赖 项 redis 和 bcrypt， 然后 用 
redis.createClient () 打 开 Redis 连接 。 函 数 User 可 以 合并 传人 的 参数 对 象 。 比如 说 ，new 
User ({ name: 'Tobi' }) 会 创建 一 个 对 象 ， 并 将 对 象 的 属性 name 设 为 Tobi。 


代码 清单 6-15 ”开始 创建 用 户 模型 

















const redis = require('redis'); 

const bcrypt = require('bcrypt'); 

const db = redis.createClient (); 全 创建 到 Redis 

的 长 连接 
class User { 
constructor(obj) { 
for (let key in obj) { 4 循环 遍历 传 
this[key] = obj[key]; sr 入 的 对 象 
设 定 当 前 类 


} 
} 
} 





的 所 有 属性 


| 输出 User 类 
module.exports = User; < 一 一 


现在 这 个 用 户 模型 只 是 个 架子 ， 还 需要 添加 创建 和 更 新 记录 的 方法 。 

3. 把 用 户 保存 到 Redis 中 

接 下 来 要 实现 的 功能 是 保存 用 户 ， 把 数据 存 到 Redis 中 。 代 码 清单 6-16 中 的 save 方法 会 先 
检查 用 户 是 否 有 ID ， 如 果 有 就 调用 update 方法 ， 用 名 称 索 引用 户 ID ， 并 用 对 象 的 属性 组 装 出 
Redis 哈 希 表 中 的 记录 。 如 果 没 有 ID,， 则 认为 这 是 一 个 新 用 户 , 增加 user: ias 的 值 ， 给 用 户 一 
个 唯一 也， 然后 对 密码 做 哈 希 处 理 ， 用 之 前 提 到 的 那个 updaate 方法 把 用 户 数据 存 到 Redis 中 。 
巴 下 面 的 代码 加 到 models/userjs 中 。 


代码 清单 6-16 更 新 用 户 记 录 
class User { 


A Ed 
save(cb) { 如 果 设 置 了 ID， 则 


if (this.id) { | 和 


















































dt 





this.update (cb); 
} else { 创建 唯 
db,.iner("uUuser:ide’y (err, 1d) > A < 一 ID 
if (rE) return, eb(erry): Ee 
this.id = id; 密码 
设 定 ID， this.hashPassword((err) => { < 一 一 险 希 
以 便 保 存 if (err) return cbl(err); 
this.update (cb); < 保存 用 户 
2 i 层 | 
证 | 属性 
} 
} 
update(cb) { 
Gonst 1d.= this.id; 用 名 称 索 引 
db.set (‘user:id:${this.name}., id, (err) => { < 用户 ID 
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if (err) return cbl(err); 

db.hmset (‘user:${id}., this, (err) => { 
CO(erEL)s 

有 
FD) 


4. 增强 用 户 密码 的 安全 性 

刚 创建 用 户 时 ， 需 要 将 .pass 属性 设 为 用 户 的 密码 。 然 后 用 户 保存 逻辑 会 将 .pass 属性 换 
作 经 过 哈 希 处 理 的 密码 。 

这 个 哈 希 会 加 盐 。 每 个 用 户 用 的 盐 不 一 样 ,加 盐 可 以 使 他 们 有 效 对 抗 彩 虹 表 攻击 : 对 哈 希 机 
制 来 说 ， 盐 就 像 私 钥 一 样 。 可 以 用 bcrypt 的 gensalt () 为 哈 希 生成 12 个 字符 的 盐 。 


用 Redis 存储 当 
前 类 的 属性 











| 
如 








彩虹 表 攻 击 “” 彩虹 表 攻 击 用 预先 计算 好 的 表 破解 经 过 哈 希 处 理 的 密码 。 维 基 百 科 
上 有 更 详细 的 介绍 。 











盐 生 成 好 之 后 , 调用 bcrypt .hash() 对 .pass 属性 和 盐 做 哈 硕 处 理 。 在 .updaate() 把 数据 
存 到 Redis 之 前 ，.pass 属性 的 值 会 换 成 最 终 的 哈 希 值 ， 保 证 不 会 保存 密码 的 明文 ， 只 保存 它 的 
哈 希 结果 。 

下 面 代码 中 定义 的 函数 会 创建 加 盐 的 哈 硕 , 并 把 结果 存 到 用 户 的 属性 .pass 中 。 把 它 加 到 


models/user.js 中 。 























代码 清单 6-17 ”在 用 户 模型 中 添加 becrypt 加 密 苑 数 
class User { 
A 


hashPassword (cb) { 生成 有 a 
bcrypt.genSalt (12, (err, salt) => { <、 个 字符 的 盐 
if (err) return cbl(err); 


ee this.salt = salt; 生成 哈 希 
设 定 盐 以 pcrypt .hash(this.pass, salt, (err, hash) => { 和 


便 保存 if (err) return cbl(err); 
this.pass = hash; 二 一 | 设 定 哈 希 以 
b(); 
hs 便 保存 
3 
} 
已 经 完成 了 。 


5. 测试 用 户 保存 逻辑 
我 们 来 试 一 下 ， 在 控制 台中 输入 命令 redis-server 启动 Redis 服务 器 。 把 下 面 的 代码 加 到 


models/userjs 的 最 下 面 , 创建 示例 用 户 。 然 后 运行 node models/user .js 执行 示例 用 户 的 创建 。 
代码 清单 6-18 测试 用 户 模 型 


const User 




















= require('./models/user'); 
const user = new User({ name: 'Example', pass: 'test' }); 


创建 新 用 户 


< 
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user.save((err) => { QQ i 
if (err) console.error (err); 保存 用 户 
console.log('user id %d', user.id); 


}); 

应 该 能 看 到 表明 用 户 创建 成 功 的 输出 ， 比 如 : user id 1。 测试 完成 后 ， 从 models/userjs 中 
去 掉 刚才 添加 的 示例 用 户 创 建 代码 。 

在 使 用 Redis 中 的 工具 redis-cli 时 ， 可 以 用 HGETALL 命令 取出 哈 希 表 中 的 所 有 键 和 值 ， 如 下 
所 示 。 


代码 清单 6-19 ”使 用 Redis 命令 行 工 具 进行 查询 








启动 Redis 
S$ redis-cli < 一 命令 行 找 出 最 近 创建 
redis> get user:ids J4 ”| 的 用 户 的 ID 
Li 
redis> hgetall user:1 
1) "name" 取出 哈 希 表 条 
2) "tobi" | 哈 希 表 条 目 目 中 的 数据 
3 "PAass, i 的 属性 
4) "$2a$12$BAOWTNTAkKNjY7UNtOUdBku46eDGpKpK5iJcfOeLWO8sMcfPL7 .PN." 
5) "age" 
6) "2" 
eo 
8) "4" 
9 salLE, . | 
10) "$2a$12$BAOWTHTAKNjY7Uht0UdBku" 退出 Redis 
redis> quit 二 他 令 作 


用 户 保存 的 功能 做 好 了 ， 该 添加 获取 用 户 信息 的 功能 了 。 
其 他 的 REDIS-CLI 命令 Redis 命令 参考 手册 中 有 更 多 介绍 Redis 命令 的 内 容 。 

6. 获取 用 户 数据 

在 Web 程序 中 ,用 户 登 录 通 常 是 在 表单 中 输入 用 户 名 和 密码 ， 然 后 把 这 些 数据 提交 给 后 台 
进行 认证 。 在 得 到 登录 表单 提交 的 数据 后 ， 需 要 一 个 能 通过 用 户 名 获取 用 户 信息 的 方法 。 

下 面 代码 中 的 User .getByName () 就 是 这 样 的 方法 。 这 个 函数 先 用 User .getId() 查找 用 
户 DD,， 然后 把 ID 传 给 user .get () ， 由 它 负责 取得 Redis 哈 希 表 中 的 用 户 数据 。 把 下 面 的 方法 
加 到 models/userjs 中 。 


代码 清单 6-20 ”从 Redis 中 取得 用 户 数据 


class User { 



































VA 
static getByName (name, cb) { 根据 名 称 查找 
User.getId(name, (err, id) => { < 用 户 ID 
if (err) return cbl(err); 
User.get (id, cb); 用 ID 抓 取 


人 用 户 
} 
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static getId(name, cb) { 取得 由 名 称 
db.get (‘user:id:${name}., cb); 二 索引 的 ID 
} 
static get (id, cb) { 获取 普通 对 
db.hgetall(‘user:${id}., (err, user) => { 二 象 哈 希 
if (err) return cbl(err); 
i ; 
Sb new User (user)) 将 普通 对 象 转换 成 


}); 
} 
} 


如 果 想 斌 一下， 可 以 用 下 面 这 样 的 代码 : 
User.getByName('tobi', (err, user) => { 
console.log(user);} 
}) 
现在 已 经 可 以 获取 经 过 哈 希 的 密码 了 ， 我 们 继续 实现 用 户 认证 功能 。 
7. 用 户 登 录 认 证 
用 户 认证 所 需 的 最 后 一 个 方法 在 下 面 的 代码 清单 中 , 前 面 定 义 的 用 户 数 据 获取 函数 派 上 用 场 
了 。 把 它 添加 到 models/user.js 中 。 


代码 清单 6-21 用 户 名 和 密码 认证 
static authenticate(name, pass, cb) 


{ 
User.getByName (name, (err, user) => { 


if (err) return cbl(err); E 
if (!user.id) return cb(); <、 用 户 不 存在 


新 的 User 对 象 























通过 用 户 名 查找 用 户 


对 给 出 的 bcrypt.hash(pass, user.salt, (err, hash) => { 
密码 做 哈 if (err) return cbl(err); > mI 
希 处 理 if (hash == user.pass) return cp(null, user); <- 一 匹配 发 现 项 
Chi()sy < 一 
- | 密码 无 效 


人 
} 


认证 功能 一 开始 先 用 用 户 名 查找 用 户 记 录 。 如 果 没 找到 ,马上 调用 回调 函数 。 反 之 把 保存 在 
用 户 对 象 中 的 盐 和 提交 上 来 的 密码 做 哈 希 处 理 ， 产 生 的 结果 应 该 跟 user .pass 的 哈 希 值 相同 。 
如 果 两 个 哈 希 值 不 匹配 ， 说 明 用 户 输入 的 凭证 是 无 效 的 。 当 查找 不 存在 的 键 时 ， Redis 会 返回 一 
个 空 的 哈 希 值 ， 所 以 这 里 的 检查 办 法 是 !user .iqd， 而 不 是 !user。 

现在 用 户 认证 做 好 了 ， 该 实现 用 户 注册 功能 


















































6.2.6 ”注册 新 用 户 
为 了 让 用 户 创 建新 账号 后 登录 ， 需 要 提供 注册 和 登录 功能 。 
本 节 需 要 完成 下 面 的 任务 实现 注册 : 
口 将 注册 和 登录 路 由 映射 到 URL 路 径 上 ; 
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口 添加 显示 注册 表单 的 广 册 路 由 处 理 器 ; 
口 实现 用 户 数据 存储 功能 ， 存 储 从 表单 提交 上 来 的 用 户 数据 。 
表单 如 图 6-12 所 示 。 











Register 


Fill in the form below to sign up! 


Sign Up 




















图 6-12 ”用 户 注册 表单 























这 个 表单 是 在 浏览 器 访问 /register 时 显示 的 。 稍 后 还 要 创建 一 个 类 似 的 登录 表单 。 

1. 添加 注册 路 由 

要 显示 注册 表单 ， 首 先 要 创建 一 个 路 由 泻 染 这 个 表单 ， 然 后 把 它 返 回 给 用 户 的 浏览 器 显示 
出 来 。 

参照 代码 清单 6-22 修改 app.js， 这 段 代码 用 Node 的 模块 系统 从 routes 目录 中 引入 定义 注册 
路 由 行为 的 模块 , 并 将 HTTP 方法 及 URL 路 径 关 联 到 路 由 函数 上 。 由 此 构成 一 个 “前 端 控 制 器 ”。 
如 你 所 见 ， 这 里 既 有 cET 注册 路 由 ， 也 有 POST 注册 路 由 。 

















代码 清单 6-22 ”添加 注册 路 由 
引入 路 由 逻辑 


const register = require('./routes/register'); 


app.get ('/register', register.form); :天 
l 有 、 l 添加 路 由 
app.post('/register', register.submit); 


接 下 来 定义 路 由 逻辑 ， 先 在 routes 目录 下 创建 registerjs 文件 。 把 下 面 的 代码 添加 到 routes/ 
registerjs 中 ， 输 出 浑 染 注册 模板 的 路 由 : 


exports.form = (req, res) => { 
res.render('register', { title: 'Register' }); 


ds 
这 个 路 由 用 到 了 一 个 EJS 模板 ， 我 们 接 下 来 创建 用 于 定义 注册 表单 的 HTML 的 模板 。 


2. 创建 注册 表单 
为 了 定义 注册 表单 的 HTML， 需 要 在 views 目录 下 创建 register.ejs 文件 。 可 以 用 下 面 这 个 代 


码 清单 中 的 HTML/EJS。 
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代码 清单 6-23 ”注册 表单 的 视图 模板 


<!DOCTYPE html> 
<html> 
<head> 
<title><%$= title %></title> 
<link rel='stylesheet' 
</head> 
<body> 
include menu 各 > 
<h1l><%= title %></hl> 


9 
各 看 


<p>Fill in the form below to sign up!</p> 


<%$ include messages 各 > 


<form action='/register' 
<p> 

<input 
Ch 
«Di 


type='text' 
用 户 名 是 
必 填 项 
<input type='password' 
ww place 
</p> 
和 
<input 
</p> 
</form> 
</body> 
</html> 





type='submit' 


name='user [name]' 


href='/stylesheets/style.css' /> 


0 
< 稍 后 添 添 力 


稍 后 添加 的 
< 提示 消息 


method='post'> 


placeholder='Username' 


name='user[pass]' 
holder='Password' /> 


密码 是 必 
填 项 


value='Sign Up' /> 


注意 上 面 的 include messages， 它 和 衣 人 了 另 一 个 模板 messages.ejs。 我 们 接 下 来 就 定义 这 

















个 用 来 跟 用 户 沟通 的 模板 。 
3. 把 反馈 消息 传达 给 用 户 


ini 


在 用 户 注 册 过 程 中 ， 以 及 在 大 多 数 应 月 








比如 说 ， 用 户 注 册 时 所 选 的 用 户 名 可 能 已 
这 个 程序 里 的 messages.ejs 模板 是 月 





场景 中 ， 将 反馈 消息 传达 给 用 户 都 是 必须 要 做 的 工作 。 


已 经 被 占用 了 。 这 时 要 提示 用 户 用 其 他 用 户 名 注册 。 


在 views 目录 下 创建 一 个 名 为 messages.ejs 的 文件 ， 把 下 面 的 代码 放 到 这 个 文件 里 。 这 段 代 


码 会 检查 是 否 有 变 
每 个 消息 对 象 者 
本 ), 我 们 可 以 


调用 removeMessages 清 


量 locals. messages, 


Bh 有 type 属性 ( 如 果 需 要 ， 








I 
UD 














空 消 息 队 列 : 


if (locals.messages) { %> 
<g messages.forEach( (message) 


9 
去 五 


<p Class='<%= message.type %>'>< 


<%$ }) %$> 


<%$ removeMessages() 


} 


9 
> 


& & 
< 

















要 显示 的 错误 添加 到 res. 


二 

















来 显示 错误 的 。 它 会 租 入 到 很 多 模板 中 。 
如 果 有 ， 模 板 会 循环 遍历 这 个 变量 以 显示 消息 对 象 。 
可 以 用 消息 做 非 错误 通知 ) 和 string 属性 (消息 文 























locals.messages 数组 中 形成 队列 。 消 息 显 示 之 后 ， 


& 
> 

& 

= 


message.string %></p> 


图 6-13 是 显示 错误 报告 时 的 注册 表单 。 
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Register 


Fill in the form below to sign up! 


Username already taken! 


| Sign Up | 





图 6-13 显示 错误 报告 时 的 注册 表单 


向 res .locals.messages 中 添加 消息 是 一 种 简单 的 用 户 沟通 方式 ， 但 在 重 定向 后 res.1locals 
会 丢失 ， 所 以 如 果 要 跨越 请 求 传递 消息 ， 那 么 需要 用 到 会 话 。 

4. 在 会 话 中 存放 临时 的 消息 

Post/Redirect/Get ( PRG ) 是 一 种 常用 的 Web 程序 设计 模式 。 这 种 模式 是 指 ， 用 户 请 求 表 单 ， 
表单 数据 作为 HTTP PosT 请 求 被 提交 ， 然 后 用 户 被 重 定向 到 另外 一 个 Web 页 面 上 。 用 户 被 重 定 
向 到 哪里 取决 于 表单 数据 是 否 有 效 。 如 果 表 单数 据 无 效 ,程序 会 让 用 户 回 到 表单 页 面 。 如 果 表 单 
数据 有 效 ， 程 序 会 让 用 户 到 新 的 Web 页 面 中 。PRG 模式 主要 是 为 了 防止 表单 的 重复 提交 。 

在 Express 中 ， 用 户 被 重 定向 后 ，res .locals 中 的 内 容 会 被 重 置 。 如 果 把 发 给 用 户 的 消息 
存在 res .locals 中 ,这 些 消息 在 显示 之 前 就 已 经 和 了。 把 消息 存在 会 话 变量 中 可 以 解决 这 个 
问题 。 确 保 消息 在 重 定向 后 的 页 面 上 仍然 能 够 显示 。 

我 们 要 添加 一 个 模块 ， 让 它 在 一 个 会 话 变量 中 维护 用 户 消 息 队 列 。 创 建文 件 .middleware/ 
messagesjs， 加 入 下 面 这 些 代 码 : 


const express = require('express'); 



















































































function message(req) { 
return (msg, type) => { 
type = type || 'info'; 
let sess = req.session; 
sess.messages = sess.messages || []; 
sess.messages.push({ type: type, string: msg }); 
过 
中 


res .message 因数 可 以 把 消息 添加 到 来 自任 何 Express 请 求 的 会 话 变量 中 。express .respons 
对 象 是 Express 给 响应 对 象 用 的 原型 。 所 有 中 间 件 和 路 由 都 能 访问 到 添加 到 这 个 对 象 中 的 属性 。 
在 前 面 的 代码 中 , express .response 被 赋值 给 了 一 个 名 为 res 的 变量 , 这 样 添 加 属性 更 容易 ， 
可 读 性 也 提高 了 。 

这 个 功能 需要 会 话 支持 ， 为 此 我 们 需要 一 个 跟 Express 兼容 的 中 间 件 模块 ， 官 方 支持 的 包 是 


express-session。 用 npm install --save express-session 安装 ， 然 后 把 它 添加 到 app.js 中 : 












































128 第 6 章 深入 了 解 Connect 和 Express 





const session = require('express-session'); 


app.usel(session({ 
secret: 'secret', 
resave: false, saveUninitialized: true 


Fes 

这 个 中 间 件 最 好 放 在 cookie 后 面 (26 行 附近 )。 

为 了 让 添加 消息 变 得 更 容易 ， 再 加 上 下 面 这 段 代 码 。 用 res .error 孙 数 可 以 轻松 地 将 类 型 
为 error 的 消息 添加 到 消息 队列 中 。 它 用 到 了 在 前 面 那个 模块 中 定义 的 res .message 沼 数 : 

res.error = msg => this.message (msg, 'error'); 

最 后 一 步 是 把 这 些 消息 输出 到 模板 中 显示 。 如 果 不 做 这 一 步 , 就 只 能 把 req. session.messages 
传 给 每 个 res .rengder () 调用， 这 很 不 明智 。 

为 了 解决 这 个 问题 , 我 们 要 创建 一 个 中 间 件 , 在 每 个 请 求 上 用 res .session.messages 上 
的 内 容 组 装 出 res .locals .messages， 这 样 可 以 更 高 效 地 把 消息 输出 到 所 有 要 泻 染 的 模板 上 。 
到 目前 为 止 ，./middleware/messages.js 只 是 扩展 了 响应 的 原型 ， 还 没 输出 任何 东西 。 把 下 面 的 代 
码 加 到 这 个 文件 中 ， 输 出 我 们 需要 的 中 间 件 : 
























































module.exports = (req, res, next) => { 
res.message = message (req); 
res.error = (msg) => { 


return res.message (msg, 'error'); 
es 
res.locals.messages = regq.session.messages || []; 
res.locals.removeMessages = () => { 
req.session.messages = []; 
} 
next () ; 
J} 
它 首先 定义 了 一 个 模板 变量 messages， 用 来 存放 会 话 中 的 消息 ; 这 是 一 个 数组 ， 在 上 一 个 
请 求 中 可 能 存在 ， 也 可 能 不 存在 (这 些 是 存在 会 话 里 的 消息 )。 接 下 来 ， 还 需要 一 个 把 消息 从 会 
话 中 移 除 的 办 法 ， 和 否则 它们 会 因为 没 人 清理 而 越 积 越 多 。 
现在 只 要 在 app.js 中 require() 这 个 文件 就 可 以 集成 这 个 新 功能 了 。 这 个 中 间 件 应 该 放 在 
中 间 件 session 下 面 ， 因 为 它 要 依赖 req. session。 注意 一 下 ,因为 这 个 中 间 件 既 不 接受 选项 ， 也 
不 返回 第 二 个 函数 ， 所 以 可 以 调用 app.use (messages), 而 无 须 调用 app .use (messages ())。 
为 将 来 考虑 ， 不管 是 否 接 受 选 项 ， 第 三 方 中 间 件 最 好 用 app .use (messages () ) : 



































Const register = require('./routes/register'); 
Const messages = require('./middleware/messages'); 


app.use (express.methodOverride()); 
app.use (express.cookieParser ()); 
app.use (session({ 
secret: 'secret', 
resave: false, 
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saveUninitialized: true 
3 
app.use (messages); 


这 样 任何 视图 中 都 可 以 访问 到 messages 和 removeMessages () 了 ， 所 以 ， 不 管 出 现在 哪 
个 模板 中 ，messages.ejs 应 该 都 可 以 圆满 完成 任务 。 

注册 表单 的 显示 做 好 了 , 还 解决 了 向 用 户 传达 反馈 信息 的 问题 。 接 下 来 继续 前 进 ， 去 处 理 注 
册 表 单 的 提交 吧 。 

5. 实现 用 户 注册 

我 们 需要 一 个 路 由 函数 来 处 理 提 交 到 /register 上 的 HTTP PosT 请 求 。 可 以 将 这 个 函数 命名 
为 submit。 

当 表 单数 据 提交 上 来 时 ,中 间 件 podyParser () 会 用 这 些 数据 组 装 req.body。 注册 表单 使 用 了 
对 象 表示 法 user [name] ,经 过 解析 后 会 变 成 req .body .user .name。 同样 ，red.pboqy .user.pass 
表示 密码 输入 域 。 

表单 提交 路 由 处 理 器 中 的 代码 很 少 , 我 们 只 需要 处 理 校 验 ， 比 如 确保 用 户 名 未 被 占用 ; 还 有 
保存 新 用 户 ， 如 代码 清单 6-24 所 示 。 
注册 一 完成 ， 就 会 把 user .id 赋值 给 会 话 变量 ， 稍 后 还 要 通过 检查 它 是 否 存在 来 判断 用 户 
是 否 通过 了 认证 。 如 果 校 验 失败 ， 消 息 会 作为 messages 变量 通过 *es.1locals.messages 输 
出 到 模板 中 ， 并 且 用 户 会 被 重 定向 回 注册 表单 。 

请 把 下 面 的 代码 添加 到 routes/register.js 中 实现 这 一 功能 。 


代码 清单 6-24 ”用 提交 的 数据 创建 用 户 


const User = require('../models/user'); 






























































exports.submit = (req, res, next) => { 
const data = req.body.user; 
User.getByName (data.name, (err, user) => { ~ 
if (err) return next (err); i 
顺延 传递 // redis will default it 雷 百 用 
数据 库 连 if (user.id) { 
接 错误 和 res.error('Username already taken!'); 
其 他 错误 res.redirect ('back'); 
else { 
user = new User({ 用 POST 数据 
name: data.name, 创建 用 户 
pass: data.pass 
3 
user.save((err) => { 
di if (err) return next (err); 为 认证 保 


用 户 名 已 经 
被 占用 


—- 


req.session.uid = user.id; 4 一 | 存 uid 
res.redirect('/'); Ea 
重 定向 到 记 


a 录 的 列表 页 
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现在 启动 程序 ， 访 问 /register 注册 一 个 用 户 。 接 下 来 我 们 要 让 已 注册 的 用 户 通 过 /login 表单 
进行 认证 。 
6.2.7 已 注册 用 户 登录 

实现 登录 功能 比 注册 简单 ， 因 为 之 前 定义 的 通用 认证 方法 User .authenticate() 里 已 经 有 
了 登录 所 需 的 大 部 分 代码 。 本 市 将 添加 : 
口 显示 登录 表单 的 路 由 逻辑 ; 
口 认证 从 表单 提交 的 用 户 数据 的 逻辑 。 
这 个 表单 看 起 来 应 该 如 图 6-14 所 示 。 





























Login 


Fill in the form below to sign in! 


Login | 














图 6-14 ”用户 登录 表单 


























先 从 修改 appjs 人手， 引入 登录 路 由 并 确立 路 由 路 径 : 





const login = require('./routes/login'); 


app.get ('/login', login.form); 
app.post('/login', login.submit); 
app.get('/logout', login.logout); 


接 下 来 添加 显示 登录 表单 的 功能 。 

1. 显示 登录 表单 

实现 登录 表单 的 第 一 步 是 为 与 登录 和 退出 相关 的 路 由 创建 一 个 文件 routes/login.js。 显 示 登 
录 表 单 的 路 由 逻辑 几乎 跟 之 前 实现 那个 显示 注册 表单 的 逻辑 一 模 一 样 , 唯一 的 区 别 是 模板 名 称 和 
页 面 标题 不 同 : 


exports.form = (req, res) => { 
res.render('login', { title: 'Login' }); 

7 

定义 登录 表单 的 ./views/login.ejs 跟 register.ejs 也 极其 相似 ， 只 有 说 明文 本 和 表单 提交 的 目标 


路 由 不 同 。 代 码 如 下 所 示 。 
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代码 清单 6-25 ”登录 表单 的 视图 模板 
<!DOCTYPE html> 
<html> 
<head> 
<title><%$= title %></title> 
<link rel='stylesheet' href='/stylesheets/style.css' /> 
</head> 
<body> 
< 多 include menu %> 
<hl><%= title %></hl> 
<p>Fill in the form below to sign in!</p> 
<%$ include messages 和 > 用 户 名 是 
<form action='/login' method='post'> 必 填 项 
<p> 
<input type='text' name='user[name]' placeholder='Username' /> 
</p> 
<p> 
<input type='password' name='userlpass]' 
ee Password' /> 了 一 密码 是 必 
a 填 项 
<input type='submit' value='Login' /> 
</p> 
</form> 
</body> 
</html> 


做 好 显示 登录 表单 所 需 的 路 由 和 模板 后 ， 接 下 来 要 添加 处 理 登 录 请 求 的 逻辑 。 

2. 登录 认证 

处 理 登录 请 求 需要 添加 路 由 逻辑 ,对 用 户 提 交 的 用 户 名 和 密码 进行 检查 ,如果 正确 ,将 用 户 
ID 设 为 会 话 变量 ， 并 把 用 户 重 定 向 到 首页 上 。 下 面 的 代码 包含 了 这 种 逻辑 ， 将 它们 添加 到 
routes/login.js 中 。 


代码 清单 6-26 ”处 理 登 录 的 路 由 


const User = require('../models/user'); 








exports.submit = (req, res, next) => { 
const data = req.body.user; 
User.authenticate(data.name, data.pass, (err, user) => { 





若 误 [六 TIE (err) return next (err); 
传递 if (user) { | 了 一 一 一 一 一 一 处 理 凭证 有 
req.session.uid = user.id; 为 认证 效 的 用 户 
1 1 1 * : 
重 定向 到 记 政 庆 res.redirect('/'); 存储 uid 输出 错误 
录 列 表 页 ) else { 
res.error('Sorry! invalid credentials. '); 二 一 消息 
res.redirect ('back'); 重 定向 回 


: 登录 表单 
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如 果 用 户 是 使 用 User.authenticate() 认 证 ,req.session.uid 就 会 像 在 POST/register 
路 由 中 一 样 赋值 ， 这 个 值 会 保存 在 会 话 中 ， 可 以 用 它 获取 User 或 其 他 与 用 户 相关 的 数据 。 如 果 
找 不 到 匹配 的 记录 ， 会 设 定 一 个 错误 ， 并 重新 显示 登录 表单 。 

用 户 可 能 还 希望 有 主动 退出 功能 ， 所 以 应 该 在 程序 中 提供 一 个 退出 链接 。 在 appjs 中 创建 这 
个 路 由 : 


const login = require('./routes/login'); 





app.get ('/logout', login.logout) 
然后 在 ./routes/login.js 中 ， 下 面 的 这 个 函数 会 移 除 会 话 ， 这 将 被 session () 中 间 件 检测 到 ， 
其 会 为 后 续 请 求 赋予 新 的 会 话 : 
exports.logout = (req, res) 
regq.session.destroy ( (err) 
if (err) throw err; 
res.redirect('/'); 


}) 
3 


注册 和 登录 页 面 都 创建 好 了 ， 接 下 来 需要 添加 一 个 菜单 ， 让 用 户 可 以 进入 这 两 个 页 面 。 来 
看 一 下 如 何 创建 。 

3. 为 已 认证 的 和 匿名 的 用 户 创建 菜单 

本 节 会 为 匿名 的 和 已 认证 的 用 户 创建 一 个 菜单 ,让 他 们 可 以 登录 、 注册、 提交 消息 以 及 退出 。 
图 6-15 是 为 匿名 用 户 创建 的 菜单 。 





Se 
=> { 


> 











http://127.0.0.1:3000/ 


Gear cM: ac 


login register | 








图 6-15 ”用户 登录 和 注册 菜单 ， 用 来 访问 你 创建 的 表单 


用 户 通 过 认证 后 将 会 显示 男 外 一 个 菜单 ， 来 表明 其 用 户 名 以 及 发 消息 页 面 的 链接 和 退出 链 
接 。 如 图 6-16 所 示 。 


QnNn Mozilla Firefox 
http://127.0.0.1:3000/ 十 | 





(4) @ 127.0.0.1:3000 








图 6-16 用 户 通过 认证 后 的 菜单 


在 所 有 程序 页 面 的 EJS 模板 中 , 标签 <body> 之 后 都 有 这 样 一 段 代 人 码 : <s include menu %>。 
这 是 要 机 人 模板 ./views/menu.ejs， 接 下 来 马上 创建 。 
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代码 清单 6-27 匿名 和 已 认证 用 户 的 菜单 


<%$ if (locals.user) { %> 





<div id='menu'> 
<span class='name'><%= user.name %$></span> 给 已 登录 用 
<a href='/post'>post</a> 户 的 菜单 
<a href='/logout'>logout</a> 
</div> 
< 和 } else { 多 > 
<div id='menu'> : 
<a href='/login'>login</a> | 给 匿名 用 户 
<a href='/register'>register</a> 的 菜单 
</div> 
<%$ } 各 > 








在 这 个 程序 中 ,你 可 以 假定 如 果 有 user 变量 输出 到 了 模板 中 , 那么 这 个 用 户 就 已 经 通过 认 
证 了 ， 和 否则 不 会 输出 这 个 变量 。 也 就 是 说 当 这 个 变量 出 现时 ， 可 以 显示 用 户 名 、 消 息 提 交 和 退出 
链接 。 当 访问 者 是 匿名 用 户 时 ， 显 示 网 站 登录 和 注册 链接 。 

你 可 能 在 想 本 地 变量 user 是 从 哪 来 的 。 其 实 代码 还 没 写 呢 。 接 下 来 我 们 要 写 一 些 代码 为 每 
个 请 求 加 载 已 登录 用 户 的 数据 ， 并 让 模板 可 以 得 到 这 些 数据 。 


6.2.8 用 户 加 载 中 间 件 


在 做 Web 程序 时 ， 一 般 都 需要 从 数据 库 中 加 载 用 户 信 息 。 通 常会 表示 为 JavaScript 对 象 。 为 
了 使 其 与 用 户 交 互 更 简单 ， 要 保证 这 项 数据 可 持续 访问 。 在 本 章 的 程序 里 ， 要 用 中 间 件 为 每 个 请 
求 加 载 用 户 数据 。 

中 间 件 脚本 会 放 在 ./middleware/userjs 中 ， 它 会 从 上 层 目录 (..,models ) 中 引入 User 模型 。 
先是 输出 中 间 件 函数 , 然后 检查 会 话 查看 用 户 ID。 当 用 户 ID 出 现时 , 表明 用 户 已 经 通过 认证 了 ， 
所 以 从 Redis 中 取出 用 户 数 据 是 安全 的 。 

Node 是 单线 程 的 ， 没 有 线程 本 地 存储 。 对 于 HTTP 服务 右 而 言 ， 请 求 和 响应 变量 是 唯一 的 
上 下 文 对 象 。 构 建 在 Node 之 上 的 高 层 框架 可 能 会 提供 额外 的 对 象 存 放 已 认证 用 户 之 类 的 数据 ， 
但 Express 坚持 使 用 Node 提供 的 原始 对 象 。 因 此 ， 上 下 文 数据 一 般 保存 在 请 求 对 象 上 ， 比 如 在 
代码 清单 6-28 中 ， 用 户 被 存储 为 req .user， 后 续 的 中 间 件 和 路 由 可 以 用 这 个 属性 访问 它 。 

你 可 能 想 知道 给 res .1ocals .user 的 任务 是 什么 。res .1ocals 是 Express 提供 的 请 求 层 
对 象 ， 可 以 将 数据 输出 给 模板 ， 很 像 app .1ocals。 它 还 是 能 合并 已 有 对 象 的 函数 。 


代码 清单 6-28 加载 已 登录 用 户 数据 的 中 间 件 




















































































































const User = require('../models/user'); 

module.exports = (req, res, next) => { 从 会 话 中 取出 已 
const uid = req.session.uid; < 登录 用 户 的 ID 
if (!uid) return next(); 从 Redis 中 取出 已 
User.get (uid, (err, user) => { 4 登录 用 户 的 数据 


if (err) return next (err); 
req.user = res.locals.user = user; < 一 一 将 用 户 数据 输出 


next (); 到 响应 对 象 中 
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}); 

}; 

要 使 用 这 个 新 中 间 件 ， 首 先 要 删 掉 app.js 中 所 有 包含 文本 user 的 代码 。 然 后 像 往常 那样 引 
人 人 模块， 把 它 传 给 app.use() 。 在 这 个 程序 中 ，usez 出 现在 路 由 器 上 面 ， 所 以 只 有 路 由 和 在 
user 下 面 的 中 间 件 能 访问 rea .user。 如 果 你 正在 使 用 加 载 数 据 的 中 间 件 ， 就 像 这 个 中 间 件 一 
样 ， 可 能 要 把 express .static 放 到 它 上 面 。 和 否则 每 次 返回 静态 文件 时 ， 都 会 浪费 时 间 到 数据 
库 中 取 用 户 数据 。 

下 面 是 在 appjs 中 启用 这 个 中 间 件 的 代码 。 


代码 清单 6-29 局 用 用 户 加 载 中 间 件 


Const user = require('./middleware/user'); 






































app.use (express.session()); 

app.use (express.static(_ dirname + '/public')); 将 中 间 件 添 
app.use (user); < 加 到 程序 中 
app.use (messages); 

app.use(app.router); 








如 果 再 次 启动 程序 ,不管 是 访问 /login 还 是 /register， 应 该 都 可 以 看 到 菜单 。 如 果 想 给 菜单 增 
加 样式 ， 可 以 把 下 面 的 CSS 加 到 public/stylesheets/style.css 中 。 


代码 清单 6-30 ”可 以 加 到 style.css 中 给 菜单 添加 样式 的 CSS 

#menu { 
position: absolute; 
to “5DX? 
right: 20px; 
font-size: 12px; 
Color: #888; 

} 

#menu .name:after { 
CoONnbente ~ 0} 

} 

#menu a { 
text-decoration: none; 
margin-left: 5S5px; 
Olors: ‘blacks 


} 
菜单 到 位 了 ， 你 应 该 可 以 自己 注册 个 用 户 了 。 注 册 成 功 后 就 可 以 看 到 带 有 Post 链接 的 已 认 
下 一 节 将 要 介绍 如 何 给 程序 添加 REST API。 











6.2.9 ”创建 REST API 


本 节 会 创建 一 个 RESTful API， 让 第 三 方程 序 可 以 跟 我 们 的 在 线 留言 板 程 序 互动 ， 进 行 公开 
数据 的 访问 和 添加 。 按 照 REST 的 思想 ， 程 序数 据 是 可 以 用 谓词 和 名 词 ( 即 HTTP 方 法 和 URL ) 
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访问 和 修改 的 。 通 过 REST 请 求 得 到 的 数据 一 般 是 机 器 可 读 的 格式 ， 比 如 JSON 或 XML。 
实现 API 需 要 完成 下 面 这 些 任 务 : 
口 设计 一 个 让 用 户 显 示 、 列 表 、 移 除 和 提交 消息 的 API; 
口 添加 基本 认证 ; 
口 实现 路 由 ; 
口 提供 JSON 和 XML 响应 。 
能 对 API 请 求 进行 认证 和 签名 的 技术 有 很 多 种 , 但 本 书 不 准备 展开 讨论 比较 复杂 的 方案 。 仅 
以 basic-auth 包 为 例 介绍 如 何 集成 认证 功能 。 
1. 设计 API 
在 动手 写 代 码 之 前 最 好 先 想 清楚 会 涉及 哪些 路 由 。 我 们 会 在 RESTful API 的 路 径 前 加 上 /api， 
但 你 可 以 根据 自己 的 喜好 决定 怎么 实现 。 比 如 用 http://api.myapplication.com 这 样 的 子 域名 也 可 以 。 
从 下 面 的 代码 来 看 ， 与 其 将 回调 函数 放 在 app .VERB () 调用 里 ， 不 如 把 它 做 成 单独 的 Node 
模块 。 保 持 路 由 列表 的 清爽 简洁 , 可 以 让 你 对 你 们 团队 在 做 什么 ,以 及 这 些 回 调 在 哪里 实现 一 目 
了 然 : 
app.get ('/api/user/:id', api.user); 


app.get ('/api/entries/:page?', api.entries); 
app.post('/api/entry', api.add); 


2. 添加 基本 的 认证 

之 前 说 过 , 很 多 保证 API 安 全 和 限制 API 访 问 的 办 法 都 不 在 本 书 的 讨论 范围 之 内 。 但 认证 过 
程 还 是 要 介绍 一 下 的 ， 简 单 起 见 ， 这 里 以 基本 认证 为 例 。 

我 们 将 用 中 间 件 api .auth 实现 这 一 过 程 ， 具 体 实现 会 放 在 ./routes/apijs 模块 里 。app. use () 
方法 可 以 接受 路 径 参 数 ， 这 在 Express 中 被 称 为 挂 载 点 。 不 管 是 什么 HTTP 谓词 ， 只 要 请 求 的 路 
径 以 挂 载 点 开头 ， 就 会 触发 这 个 中 间 件 。 

下 面 这 段 代 码 中 的 app .use ('/api'，api.autn) 应 该 放 在 加 载 用 户 数 据 的 中 间 件 前 面 。 
这 样 可 以 稍 后 再 修改 用 户 加 载 中 间 件 ， 为 已 认证 的 API 用 户 加 载 数 据 : 










































































const api = require('./routes/api'); 
app.use('/api', api.auth); 


app.use (user); 


要 执行 基本 认证 ; 先 要 安装 basic-auth 模块 . npm install --save basic-autho。o 接着 创 
建 ./routes/apijs， 引 入 Express 和 用 户 模型 。 可 以 用 basic-auth 从 请 求 中 获取 基本 认证 凭证 ， 然 后 
交 给 User .authenticate 进行 认证 : 





const auth = require('basic-auth'); 
const express = require('express'); 
const User = require('../models/user'); 
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exports.auth = (req, res, next) => { 
const { name, pass } = auth (req); 
User.authenticate(name, pass, (err, user) => { 
if (user) regq.remoteUser = user; 
next (err); 
}) a 
J} 


认证 已 经 准备 好 了 ， 接 下 来 我 们 去 实现 API 的 路 
3. 实现 路 由 





可 


























第 一 个 要 实现 的 路 由 是 GET /api/user/ :id。 先 根据 ID 取得 用 户 数据 ， 如 果 用 户 不 存在 ， 
则 返回 404 Not Found 的 响应 状态 码 。 如 果 用 户 存在 , 则 将 用 户 数据 传 给 res .json () 做 串 行 化 











处 理 ， 并 以 JSON 格式 返回 该 数据 。 将 下 面 的 代码 加 到 routes/api.js 中 : 


exports.user = (req, res, next) => { 
User.get (req.params.id, (err, user) => { 
i Er) ,etUrn next (err): 
if (!user.id) return res.sendSstatus(404); 
res.json(user); 
让 ) 训 
中 


然后 将 这 个 路 由 加 到 appjs 中 : 

app.get ('/api/user/:id', api.user); 
接 下 来 可 以 测试 一 下 。 

4. 测试 用 户 数据 获取 





启动 程序 , 然后 用 命令 行 工具 cURL 进行 测试 。 下面 是 测试 REST 认证 的 示例 命令 。URL 中 





提供 了 和 凭证 tobi :ferret， cURL 用 它 生 成 Authorization 请 求 头 域 : 


S curl http://tobi:ferret@127.0.0.1:3000/api/user/l1 -vy 























下 面 是 测试 成 功 时 返回 的 结果 。 如 果 你 想 亲 上 自动 手 试 一 下 ,需要 先 找到 一 个 用 户 的 太 。 如 











果 1 不行， 可 以 用 redis-cli 的 GET user:iqds， 找 出 你 注册 过 的 用 户 数据 看 看 。 
代码 清单 6-31 测试 输出 


* About to connect() to local port 80 (#0) 





* Trying 127.0.0.1... connected 

* Connected to local (127.0.0.1) port 80 (#0) 

* Server auth using Basic with user 'tobi' 显示 发 送 的 
> GET /api/user/1 HTTP/1.1 < HTTP 头 


> Authorization: Basic 2Zm9vYmFyYmF6Cd== 
> User-Agent: curl/7.21.4 (universal-apple-darwin11.0) libcurl/7.21.4 
ww OpenSSL/0.9.8r zlib/1.2.5 


SHOES Local 

> Accept: */* E 
显示 接收 到 
< HTTP/1.1 200 OK < 的 HTTP 头 
全 


X-Powered-By: Express 


6.2 Express 137 





一 下 : 1i i j et =utf-— 
< Content-Type: application/json; charset=utf-8 显示 接收 到 的 
< Content-Length: 150 

JSON 数据 
< Connection: keep-alive 
< 
{ 


人 : "name": tobi" 上 
5. 去 掉 敏 感 的 用 户 数据 
正如 你 通过 JSON 响应 看 到 的 ， 用 户 的 密码 和 盐 都 在 。 我 们 可 以 在 models/userjs 中 的 User 
上 实现 .toJsoN() 把 它们 去 掉 : 

















class User { 
PY 
toJSON() { 
return { 
Td Cliie Ld; 
name: this.name 
} 


如 果 有 .toJSON，JSON.stringify 就 会 用 它 返回 的 JSON 数据 。 现 在 再 发 送 之 前 那个 cURL 
请 求 ， 就 只 有 ID 和 name 属性 了 : 


{ 
tds 和 
"name": "tobi" 


接 下 来 添加 创建 消息 的 API。 
6. 添加 消息 

1 API 添加 消息 的 实现 和 通过 HTML 表单 添加 的 实现 几乎 一 模 一 样 ， 所 以 可 以 重用 
之 前 实现 的 entries .supbmit () 路 由 逻辑 。 

然而 在 entries.submit () 中 ,消息 中 要 有 用 户 名 和 其 他 细节 信息 。 所 以 需要 修改 用 户 加 
载 中 间 件 , 用 basic-auth 中 间 件 加 载 的 用 户 数据 组 装 res .1ocals .user。 之 前 在 进行 基本 认 
证 时 ， 我 们 将 用 户 数据 设 为 了 请 求 对 象 的 属性 rea.remoteUser。 那 现在 只 要 在 用 户 加 载 中 间 
件 中 检查 这 个 属性 就 可 以 了 。 按照 下 面 这 样 修改 middleware/user.js 中 的 module.exports 定义 ， 
用 户 加 载 中 间 件 就 能 跟 API 进行 协作 了 : 




















module.exports = (req, res, next) => { 

if (req.remoteUser) { 
res.locals.user = req.remoteUser; 

} 

const uid = regq.session.uid; 

if (!uid) return next(); 

User.get (uid, (err, user) => { 
if (err) return next (err); 
req.user = res.locals.user = user; 
next (); 

3 
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这 样 改 完 之 后 就 可 以 通过 API 添 加 消息 了 。 
不 过 还 有 一 个 问题 ， 现 在 添加 消息 的 响应 还 是 重 定向 到 首页 ， 我 们 要 针对 API 请 求 调整 一 下 。 
像 下 面 这 样 修改 routes/entries.js 中 的 entry . save: 











entry.save(err => { 
if (err) return next (err); 
if (req.remoteUser) { 
res.json({ message: 'Entry added.' }); 
} else { 
res.redirect('/'); 
} 
2 


最 后 ， 为 了 启用 消息 添加 API， 将 下 面 的 代码 添加 到 app.js 中 的 路 
app.post('/api/entry', entries.submit); 
用 下 面 的 cURL 命令 测试 消息 添加 API。 它 发 送 的 标题 和 内 容 主 体 数据 所 用 的 名 称 跟 HTML 
表单 输入 域 的 名 称 相同 : 


$ curl -XxX POST -d "entryl[ltitle]='Ho ho ho'&entryl[body]='Santa loves you'™" 
http://tobi:ferret@127.0.0.1:3000/api/entry 


创建 消息 的 API 做 好 了 ， 该 添加 获取 消息 的 API 了 。 

7. 支持 消息 列表 

接 下 来 要 实现 的 API 路 由 是 GET /api/entries/:page?。 这 个 路 由 实现 跟 ./routes/entries.js 
中 的 消息 列表 路 由 几乎 一 模 一 样 。 只 是 还 要 添加 分 页 中 间 件 ， 即 下 面 代码 中 用 到 的 page () ， 我 
们 稍 后 再 实现 这 个 中 间 件 。 

因为 要 用 到 消息 ， 所 以 需要 在 routes/apijs 的 顶部 加 入 下 面 这 行 代 码 引 入 Entry 模型 : 





一 





部 分 : 












































const Entry = require('../models/entry'); 
接 下 来 把 下 面 的 代码 添加 到 app.js 中 : 


const Entry = require('./models/entry'); 














SOE ee 避让 交 page (Entry.count), api.entries); 
现在 把 下 面 的 代码 添加 到 routes/api.js 中 。 这 段 代码 和 routes/entries.js 中 对 应 代码 的 差别 是 
它 不 再 泻 染 模板 ， 而 是 返回 了 JSON: 


exports.entries = (req, res, next) => { 
const page = req.page; 
Entry.getRange (page.from, page.to, (err, entries) => { 
if (err) return next (err); 
res.json(entries); 
让 
3 
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8. 实现 分 页 中 间 件 
在 分 页 时 , 要 用 查询 字符 串 ?page=N 来 确定 当前 页 面 。 把 下 面 的 中 间 件 函数 加 到 .middleware/ 
page.js 中 。 


代码 清单 6-32 分 页 中 间 件 

















本 站 2 每 页 记录 条 数 
module.exports = (cb, perpage) => { 的 默认 值 为 10 
perpage = perpage || 10; 和 
return (req, res, next) => { 一 J 返回 中 间 
let page = Math.max( | 
parseInt (req.params .page || '1', 10), 将 参数 解析 为 
1 寸 今 外 page 日 
和 ， | 十 进 制 的 整 型 值 
ea (err, total) => { < 一 调用 传 入 
传递 if (err) return next (err); 
错误 req.page = res.locals.page = { 
number: page, 保存 page 属性 
perpage: perpage, 以 便 将 来 引用 


from: page * perpage, 

to: page * perpage + perpage - 1, 
total: total, 

count: Math.ceil(total / perpage) 


}; 
mex (a 所 | 将 控制 权 交 给 6 


下 一 个 中 间 件 





}; 
个 中 间 件 抓 取 赋 给 ?page=N 的 值 ， 比 如 ?page=1。 然 后 取得 结果 集 的 总 数 ， 2 
Ee page 对 象 ， 把 它 输出 到 需要 泻 染 的 视图 中 。 把 这 些 值 放 在 模板 外 计算 可 以 减少 
| 的 逻辑 ， 让 模板 保持 简洁 。 
9. 测试 消息 路 由 
he cURL 命令 从 API 获 取消 息 
$ curl http://tobi:ferret@127.0.0.1:3000/api/entries 


这 条 命令 的 输出 结果 应 该 和 下 面 的 JSON 差不多 : 


"username": "rick", 

"title": "Cats can't read minds", 

"body": "I think you're wrong about the cat thing." 
} 

"username": "mike", 

"title": "I think my cat can read my mind", 

"body": "I think cat can hear my thoughts." 


}, 





基本 的 API 实 现 已 经 做 完了 ， 接 下 来 我 们 看 看 如 何 让 API 支持 多 种 格式 的 响应 。 
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6.2.10 ”启用 内 容 协商 


内 容 协 商 让 客户 端 可 以 指定 它 乐于 接受 且 喜 欢 的 数据 格式 。 本 节 会 介绍 如 何 让 API 提供 
JSON 和 XML 格式 的 数据 ， 以 便 API 的 使 用 者 可 以 决定 它们 想 要 哪 种 格式 的 数据 。 

HTTP 通过 Accept 请 求 头 域 提供 了 内 容 协 商机 制 。 比 如 说 , 某 个 客户 端 可 能 更 喜欢 HTML， 
但 也 可 以 接受 普通 文本 ， 则 可 以 这 样 设 定 请 求 头 : 

Accept : text/plain; gq=0.5, text/html 


qvalue 或 quality value ( 例子 中 的 gq=0 .5 ) 表明 即便 text /html 放 在 了 第 二 个 ， 它 的 优先 
级 也 要 比 text /plain 高 50%。 Express 会 解析 这 个 信息 并 提供 一 个 规范 化 的 req .accepted 
数组 : 


[{ value: 'text/html', quality: 1 }, 
{ value: 'text/plain', quality: 0.5 } 


Express 还 提供 了 res .format () 方 法 , 它 的 参数 是 一 个 MIME 类 型 的 数组 和 一 些 回调 函数 。 
Express 会 决定 客户 端 愿意 接受 什么 格式 的 数据 ， 以 及 你 愿意 提供 什么 格式 的 数据 ， 然 后 调用 相 
应 的 回调 函数 。 

1. 实现 内 容 协 商 

在 routes/api.js 中 ， 支 持 内 容 协商 的 GET /api/entries 路 由 看 起 来 应 该 像 代码 清单 6-33 
那样 。JSON 像 之 前 那样 被 支持 一 -用 res .senad () 发 送 串 行 化 为 JSON 的 消息 数据 。XML 回调 
循环 遍历 消息 ， 并 将 其 写 入 socket 中 。 注 意 ， 没 必要 显 式 设 定 Content-Type, res.format () 
会 自动 设 定 关联 的 类 型 。 


代码 清单 6-33 ”实现 内 容 协 商 










































































exports.entries = (req, res, next) => { 
const page = req.page; 获取 消息 数据 
Entry.getRange (page.from, page.to, (err, entries) => { 一 


if (err) return next (err); 
res.format ({ 二 


JSON 'application/json': () => { 基于 Accept 头 的 什 
响应 res.send(entries); 返回 不 同 的 响应 
Dy 
'application/xml': () => { i 
res.write('<entries>\n'); XML 响应 





entries.forEach((entry) => { 
res.write(... 
<entry> 
<title>s{entry.title}</title> 
<body>s$ {entry.body}</body> 
<username>s$s{entry.username}</username> 
</entry> 


J 
3 


res.end('</entries>'); 
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} 
a 
}; 
如 果 设 定 了 默认 响应 格式 回调 ， 当 用 户 请 求 的 格式 不 在 你 特意 提供 的 格式 中 时 ,就 会 执行 这 
个 默认 的 回调 函数 。 
res.format () 方 法 还 可 以 将 扩展 名 映射 到 相关 联 的 MIME 类 型 上 。 比 如 可 以 用 json 和 xml 
代替 application/json 和 application/xml， 就 像 下 面 这 样 : 











res.format ({ 
jon ce) = 
res.sendl(entries); 
ms > 
res.write('<entries>\n'); 
entries.forEach((entry) => { 
res.write(... 
<entry> 
<title>s{entry.title}</title> 
<body>s$ {entry.body}</body> 
<username>s$s{entry.username}</username> 





</entry> 
) 去 
es 
res.end('</entries>'); 
} 
} 
2. XML 响应 
在 路 由 中 写 这 么 一 大 堆 代 码 只 是 为 了 返回 XML 响应 ， 这 并 不 是 最 简洁 的 办 法 ， 接 下 来 我 们 
要 用 视图 系统 实现 这 一 功能 。 

用 下 面 的 EJS 创建 一 个 名 为 /views/entries/xml.ejs 的 模板 , 它 会 循环 遍历 消息 生成 <entry> 标 签 。 


代码 清单 6-34 用 EJS 模板 生成 XML 

















i 





<entries> 循环 遍历 每 
<$ entries.forEach(entry => { %$> < | 条 消息 
<entry> 


<title><%= entry.title %$></title> < 
<body><%$= entry.body %$></body> | 输出 消息 中 的 各 个 域 
<username><%$= entry.username %></username> 
</entry> 
< 和 }) $> 
</entries> 


现在 可 以 把 原来 的 XML 回调 换 成 以 消息 数组 为 参数 的 res .render () 了， 像 下 面 这 样 : 
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I (SS 
res.render('entries/xml', { entries: entries }); 
} 
}) 























来 测试 一 下 API 的 XML 版 本 吧 。 输 入 下 面 的 命令 ， 看 看 输出 是 不 是 XML : 


cur] -i -H 'Accept: application/xml' 
ww http://tobi:ferret@127.0.0.1:3000/api/entries 


6.3 总 结 


口 Connect 是 一 个 HITP 框架， 可 以 在 处 理 请 求 之 前 和 之 后 堆 徐 中 间 件 。 

口 Connect 中 间 件 是 个 函数 ， 它 的 参数 包括 Node 的 请 求 和 响应 对 象 、 一 个 调用 下 一 个 中 间 
件 的 函数 ， 以 及 一 个 可 选 的 错误 对 象 。 

口 Express Web 程序 也 是 用 中 间 件 搭建 的 。 

口 在 用 Express 实现 RESTAPI 时 ， 可 以 用 HTTP 谓词 定义 路 由 。 
口 Express 路 由 的 响应 可 以 是 JSON 、HTML 或 其 他 格式 的 数据 。 
口 Express 有 个 简单 的 模板 引擎 API， 支 持 很 多 种 引擎 。 
























































Web 程序 的 模板 








本 章 内 容 

口 用 模板 组 织 程序 

口 用 Embedded JavaScript 创建 模 板 
口 学 习 极 简 风 格 的 Hogan 模板 

口 用 Pug 创建 模板 








在 第 3 章 和 第 6 章 ， 为 了 在 Express 程序 中 创建 视图 ， 我 们 介绍 过 一 些 模板 的 基础 知识 。 接 
下 来 本 章 将 专门 介绍 模板 。 我 们 会 讲 到 三 个 热门 的 模板 引擎 ,以 及 如 何 用 模板 把 显示 层 标记 从 你 
辑 代码 中 分 离 出 来 ， 保 持 Web 程序 代码 的 整洁 性 。 

如 果 你 熟悉 模板 和 模型 -视图 -控制 器 (MVC ) 模式 ,可 以 直接 进入 7.2 节 开 始 学 习 。 我 们 会 
详细 介绍 Embedded JavaScript、Hogan 和 Pug 三 个 模板 引擎 。 如 果 对 模板 不 太 了 解 ， 请 继续 往 下 
看 ， 接 下 来 的 几 节 将 会 介绍 模板 这 一 概念 。 


7.1 用 模板 保持 代码 的 整洁 性 


在 Node 中 可 以 像 其 他 Web 技术 一 样 ， 用 MVC 模式 开发 传统 的 Web 程序 。MVC 的 主要 思 
想 是 将 逻辑 、 数 据 和 展示 层 分 离 。 在 遵循 MVC 模式 的 Web 程序 中 , 一般 是 用 户 向 服务 器 请 求 资 
源 , 然后 控制 器 向 模型 请 求 数据 , 得 到 数据 后 传 给 视图 , 再 由 视图 以 特定 格式 将 数据 呈现 给 用 户 。 
MVC 中 的 视图 部 分 一 般 会 用 到 某 种 模板 语言 。 在 使 用 模板 时 ， 视 图 会 将 模型 返回 的 数据 传递 给 
模板 引擎 ， 并 指定 用 哪个 模板 文件 展示 这 些 数 据 。 

你 可 以 通过 图 7-1 了解 一 下 模板 是 如 何 融 入 MVC 程序 的 整体 架构 中 的 。 模 板 文件 中 通常 包 
含 数据 的 占 位 符 、HTML、CSS， 有 了 时 还 会 用 一 些 客户 端 JavaScript 来 做 第 三 方 小 部 件 显示 ， 比 
如 Facebook 的 点 赞 按钮 ， 或 者 触发 界面 行为 ， 比 如 隐藏 或 显示 页 面 的 某 些 部 分 。 因 为 模板 文件 
的 工作 重点 是 展示 而 不 是 处 理 逻 辑 , 所 以 前 端 开 发 人 员 和 服务 器 端 开 发 人 员 可 以 一 起 工作 , 这 样 
有 利于 项 目 任务 的 分 工 。 

本 节 会 分 别 在 用 和 不 用 模板 的 两 种 情况 下 泻 染 HTML, 让 你 看 到 两 者 之 间 的 差异 。 但 我 们 还 
是 先 看 一 个 模板 的 实例 吧 。 
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浏览 器 





1. 浏览 器 请 求 











2. 路 由 请 求 
”| 控制 器 


3. 发 送 数 据 给 视图 









4. 发 送 原始 数据 





7. 程序 响应 


6. 接受 由 模板 引擎 组 织 5. 从 硬盘 中 读 取 
好 的 HTML/CSS 模板 文件 





一 一 一 一 一 一- 
号 


图 7-1 MVC 程序 的 流程 以 及 它 跟 模 板 层 的 交互 





模板 实战 


为 了 快速 演示 一 下 如 何 使 用 模板 ， 我 们 以 一 个 简单 的 博客 程序 为 例 ， 看 它 如 何 优雅 地 输出 
HTML。 每 篇 博客 文章 都 会 有 一 个 标题 、 发 布 日 期 以 及 主体 文本 。 博 客 在 浏览 器 中 如 岁 7-2 所 示 。 








四 口中 Mozilla Firefox 
| [ed http://127.0.0.1:8000/ [ + | 4 
It's my birthday! 
January 12, 2012 
I am getting old, but thankfully T'm not in jail! 
Movies are pretty good 
January 2, 2012 


Tve been watching a lot of movies lately. Its relaxing, 
except when they have clowns in them. 





图 7-2 ”博客 程序 在 浏览 器 中 的 输出 示例 


博客 文章 是 从 文本 文件 enties.bxt 中 读 取 的 ,格式 如 下 所 示 。- - -表明 一 篇 文章 结束 , 另 一 篇 
文章 开始 。 
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代码 清单 7-1 博客 文章 文本 文件 


title: It's my birthday! 

date: January 12, 2016 

I am getting old, but thankfully I'm not in Jaill 

title: Movies are pretty good 

date: January 2, 2016 

I've been watching a lot of movies lately. It's relaxing, 
except when they have clowns in them. 


博客 程序 的 代码 放 在 blogjs 中 ， 先 引入 必要 的 模块 ， 然 后 读 和 人 博客 文章 ,代码 如 下 所 示 。 





代码 清单 7-2 博客 程序 的 文件 解析 逻辑 


const fs = require('fs'); 

const http = regquire('http'); 读 取 和 解析 博客 文 

function getEntries() { < 章 文 本 的 函数 
const entries = []; 从 文件 中 读 取 博 
let entriesRaw = fs.readFileSync('./entries.txt', 'utf8'); < 一 客 文章 的 数据 
entriesRaw = entriesRaw.split('--—-'); < 一 一 
entriesRaw.map((entryRaw) => { 解析 文本 , 将 它们 分 

const entry = {}; 成 一 篇 篇 的 文章 








const lines = entryRaw.split('\n'); 
lines.map((line) => { 解析 文章 的 文本 ， 将 
if (line.indexof('title: ') === 0) { 它们 按 行 分 解 


entry.title = line.replacel 


title Wet fe 
} else if (line.indexOf('date: ') === 0) { 
entry.date = line.replace('date: ', ''); 
} else { 


entry.body = entry.body || ''; 
entry.body += line; 
} 
3 
entries.push(entry); 
je 
return entries; 
} 
const entries = getEntries(); 
console.log(entries); 


下 面 这 段 代码 定义 了 一 个 HTTP 服务 器 ， 把 它 加 到 博客 程序 中 。 收 到 HTTP 请 求 后 ， 服 务 器 
返回 一 个 包含 所 有 文章 的 页 面 。 这 个 页 面 是 用 函数 blogPage 泻 染 的 ， 一 会 儿 再 定义 它 


const server = http.createServer((req, res) => { 
const output = blogPage (entries); 
res.writeHead(200, {'Content-Type': 'text/html'}) 
res.end (output); 

Fy 

server.listen(8000); 


接 下 来 定义 plogPage 函数 ， 用 它 把 文章 泻 染 到 HTML 页 面 中 ， 以 便 发 送 给 浏览 器 。 我 们 
































会 尝试 两 种 不 同 的 方式 : 
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口 不 用 模板 泻 染 ; 

口 用 模板 泻 染 。 

下 面 先 来 看 一 下 不 用 模板 的 情况 。 

1. 不 用 模板 渲染 HTML 

博客 程序 可 以 直接 输出 HITML， 但 在 处 理 逻 辑 中 引入 HTML 会 让 代码 变 得 很 乱 。 下 面 代 码 
中 的 blogPage 国 数 没 用 模板 显示 文章 。 


代码 清单 7-3 ”模板 引擎 把 展示 细节 和 程序 逻辑 分 开 
function blogPage (entries) { 
let output = . 
<html> 
<head> 
<style type="text/css"> 
.entry_title { font-weight: bold; } 
.entry_date { font-style: italic; } 
.entry_body { margin-bottom: lem; } 

















</style> 
</head> 
<body> 
entries.map(entry => { 逻辑 中 穿插 了 
output += 、 < 太 多 的 HTML 


<div class="entry_title">s${entry.title}</div> 
<div class="entry_date">s$s{entry.date}</div> 
<div class="entry_body">s$s{entry.body}</div> 


je 
output += '</body></html>'; 
return output; 


} 

看 看 所 有 这 些 跟 展示 相关 的 内 容 、CSS 定义 和 HTML 给 程序 添 了 多 少 行 代 码 。 

2. 用 模板 泻 染 HTML 

模板 可 以 把 HTML 从 处 理 逻 辑 中 挪 走 ， 大 幅 提 升 代码 的 整洁 性 。 

本 节 的 演示 程序 需要 用 到 Embedded JavaScript ( EJS ) 模块 ， 可 以 用 下 面 这 条 命令 安装 : 


npm install ejs 


下 面 的 代码 加 载 了 一 个 模板 文件 ，blogPage 函数 也 和 前 面 不 一 样 了 ， 这 次 用 到 了 EJS 模板 
引擎 ， 我 们 会 在 7.2 节 中 介绍 这 个 模板 引擎 的 用 法 。 


const fs = require('fs'); 
const ejs = require('ejs'); 














const template = fs.readFileSync('./templatess/blog _ page.ejs', 'utf8'); 
function blogPage (entries) { 
const values = { entries }; 


return ejs.render (template, values); 


} 
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完整 的 随 书 源码 见 ch07-templates/listing7_4/。EJS 模板 文件 是 由 HTML 标记 ( 从 处 理 逻 辑 中 
挪 过 来 的 ) 和 数据 占 位 符 ( 指示 把 数据 放 在 哪里 ) 构成 的 。 展 示 文 章 的 EJS 模板 文件 中 应 该 包含 
下 面 这 样 的 HTML 和 占 位 符 。 


代码 清单 7-4 ”显示 文章 的 EJS 模板 
<html> 
<head> 
<style type="text/css"> 
.entry_title { font-weight: bold; } 
.entry_date { font-style: italic; } 
.entry_body { margin-bottom: lem; } 
</style> 
</head> 循环 遍历 博客 
<body> 文章 的 占 位 符 
<%$ entries.map(entry => { %> < 一 
<div class="entry_title"><%= entry.title %$></div> < 一 每 篇 博客 文章 中 的 
<div class="entry_date"><%= entry.date %></div> 各 项 数据 的 占 位 符 
<div class="entry_body"><%= entry.body %$></div> 

















< 才 小 ) 3 多 > 
</body> 

</html> 

Node 社区 创建 了 很 多 模板 引擎 。HTML 需要 闭合 标签 ， 而 CSS 需要 左右 大 括号 ， 如 果 你 觉 
得 这 样 不 够 优雅 ， 那 么 可 以 认真 研究 一 下 模板 引擎 。 它 们 会 用 特殊 的 “语言 ”( 比如 我 们 后 面 会 
讲 到 的 Pug 语言 ) 以 更 简洁 的 方式 表示 HTML 或 CSS 。 

这 些 模 板 引 擎 可 以 让 模板 更 整洁 ， 但 你 可 能 不 想 花 时 间 去 学 另外 一 种 表示 HIML 和 CSS 的 
技术 。 用 不 用 最 终 还 是 要 取决 于 你 自己 。 

本 章 会 介绍 三 个 模板 引擎 ， 以 及 如 何在 Node 程序 中 使 用 它们 的 模板 : 
口 Embedded JavaScript ( EJS ) 引擎 ; 
口 极 简 的 Hogan 引擎 ; 
口 Pug 模板 引擎 。 
这 些 引擎 都 允许 用 另 一 种 方式 写 HTML。 我们 先 从 EJS 开始 。 
































7.2 Embedded JavaScript 的 模板 


Embedded JavaScript 处 理 模板 的 方式 相当 地 简单 直接 , 在 其 他 语言 中 用 过 模板 的 人 对 它 应 该 
有 种 似曾相识 的 感觉 ， 比 如 JSP (Java )、Smarty (PHP )、ERB (Ruby ) 等 模板 。 你 可 以 把 EJS 
标签 当 作 给 数据 准备 的 占 位 符 府 入 到 HTML 中 ， 还 可 以 在 模板 中 执行 纯 JavaScript 代码 ， 就 像 
PHP 那样 完成 条 件 分 支 和 循环 之 类 的 工作 。 

本 节 会 讲解 如 何 : 
口 创建 EJS 模板 ; 
口 用 EJS 过 滤器 提供 常用 的 、 与 展示 相关 的 功能 ， 比 如 文本 处 理 、 排 序 和 循环 ; 
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口 在 Node 程序 中 集成 EJS ; 
口 把 EJS 用 在 客户 端 程序 中 。 
接 下 来 我 们 要 深入 到 EJS 模板 的 世界 中 。 


7.2.1 创建 模板 


在 模板 的 世界 中 , 发 送 给 模板 引擎 做 泻 染 的 数据 有 时 被 称 为 上 下 文 。 下 面 是 EJS 用 一 个 简单 
的 模板 泻 染 上 下 文 的 例子 : 


























const ejs = require('ejs'); 
const template = '<%= message %>'; 
const context = { message: 'Hello template!' }; 


console.log(ejs.render (template, context)); 

注意 发 送 给 renger 的 第 二 个 参数 中 locals 的 用 法 。 第 二 个 参数 可 以 包含 EJS 选项 以 及 上 
下 文 数据 , 而 locals 可 以 确保 上 下 文中 数据 不 会 被 当 作 EJS 选项 。 但 大 多 数 情况 下 你 都 可 以 把 
上 下 文本 身 当 作 第 二 个 参数 ， 就 像 下 面 的 render 一 样 : 

console.log(ejs.render (template, context)); 

如 果 把 上 下 文 直接 当 作 renger 的 第 二 个 参数 , 一 定 不 要 给 上 下 文中 的 值 用 这 些 名 称 : cache、 
client、 close、 compileDebug、 debug、filename、open 或 SCopeo 它们 是 为 修改 模板 
引擎 设 定 的 保留 字 。 

字符 转 义 

在 泻 染 时 ，EJS 会 转 义 上 下 文 值 中 的 所 有 特殊 字符 , 将 它们 替换 为 HTML 实体 码 。 这 是 为 了 
防止 跨 站 脚本 (XSS ) 攻击 ， 恶 意 用 户 会 将 JavaScript 作为 数据 提交 给 Web 程序 ， 和 希望 其 他 用 户 
访问 包含 这 些 数据 的 页 面 时 能 在 他 们 的 浏览 器 中 执行 。 下 面 的 代码 展示 了 EJS 的 转 义 处 理 : 






































const ejs = require('ejs'); 
const template = '<%= message %>'; 
const context = {message: "<script>alert ('XSS attack!');</script>"}; 


console.log(ejs.render (template, context)); 


这 上段 代码 在 显示 时 会 输出 下 面 这 种 代码 : 











&lt;script&gt;alert('XSS attack!');&lt;/scripté&gt; 
如 果 用 在 模板 中 的 是 可 信和 数据 ， 不 想 做 转 义 处 理 ， 可 以 用 <%- 代 替 <%=， 像 下 面 这 样 : 
const ejs = require('ejs'); 
const template = '<%- message %>'; 
const context = { 
message: "<script>alert('Trusted JavaScript!');</script>" 


} . 


SO COntLexXt ) ) 
注意 ! 指明 EJS 标签 的 字符 是 可 修改 的 ， 比 如 像 这 样 : 


const ejs = require('ejs'); 
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ejs.delimiter = '$' 
const template = '<$= message S>' 1; 
const context = { message: 'Hello template!' }; 


console.log(ejs.render (template, context)); 


介绍 过 EJS 的 基础 知识 ， 接 下 来 我 们 看 一 些 包含 更 多 细节 的 例子 。 


7.2.2 将 EJS 集成 到 你 的 程序 中 


巴 模板 和 代码 放 在 同一 个 文件 里 很 别扭 , 并 且 会 显得 代码 很 乱 , 接 下 来 我 们 要 告诉 你 如 何 用 
Node API 从 单独 的 文件 中 读 取 模板 。 
进入 工作 目录 ,创建 appjs 文 件 ， 把 下 面 的 代码 放 在 里 面 。 


代码 清单 7-5 ”把 模板 代码 放 在 文件 中 


const ejs = require('ejs'); 
const fs = require('fs'); 











or 

















让 
const http = require('http'); 注意 模板 文 
const filename = './templates/students.ejs'; < 件 的 位 置 
const students = [ 传 给 模板 引 
{ name: 'Rick LaRue', age: 23 }, 擎 的 数据 
{ name: 'Sarah Cathands', age: 25 }, 
{ name: 'Bob Dobbs', age: 37 } 
] 
创建 HTTP 
Const server = http.createServer((req, res) => { < 服务 器 
Ll sa 
fs.readFile(filename, (err, Saba) = 从 文件 中 读 
const template = data.toString(); 取 模 板 
const context = { students: students }; 
const output = ejs.render (template, context); 了 下 泻 染 
res.setHeader('Content-type', 'text/html'); 模板 
res.end(output); < 
] ) 7 发 送 HTTP 
} :else. 响应 





res.statusCode = 404; 
res.end('Not found'); 
} 
sy 


server.listen(8000); 


接 下 来 创建 用 来 存放 模板 文件 的 子 目 录 templates， 在 templates 下 创建 students.ejs 文件 ， 把 
下 面 的 代码 放 到 students.ejs 中 。 


代码 清单 7-6 ” 演 染 学 生 数 组 的 EJS 模板 
<%$ if (students.length) { %> 
<ul> 
<$ students.forEach((student) => { 和 > 
<l1i><%$= student.name g%> (<%= student.age %>)</1i> 


去 入 直 ) 秆 汉 
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</ul> 
< 和 } %$> 


缓存 EJS 模板 

如 果 有 必要 ， 可 以 让 EJS 把 模板 函数 缓存 在 内 存 中 。 也 就 是 说 在 解析 完 模板 文件 后 ，EJS 可 以 
把 解析 得 到 的 函数 存 下 来 。 这 样 以 后 需要 演 染 这 个 模板 时 不 用 再 次 解析 ， 所 以 泻 染 速 度 会 更 快 。 

如 果 正 在 开发 过 程 当 中 ， 想 即时 看 到 模板 文件 修改 后 的 效果 ， 则 不 要 启用 缓存 。 但 在 把 程序 
部 署 到 生产 环境 中 时 ， 启 用 绥 存 是 一 种 简单 快捷 的 性 能 优化 办 法 。 可 以 通过 环境 变量 NODE_ENV 
判定 是 否 启 用 缓存 。 

如 果 想 试 一 下 ， 可 以 将 前 面 的 render 函数 调用 改 成 下 面 这 样 : 













































































Const cache = Process.env.NODE_ENV === 'production'; 
const output = ejs.render!( 
template, 


{ students, cache, filename } 
站 六 


第 二 个 参数 中 的 filename 选项 并 不 仅 限 于 文件 ， 可 以 用 要 演 染 的 模板 的 唯一 标识 。 

知道 怎么 把 EJS 集成 到 Node 程序 中 后 ， 我 们 去 看 看 如 何在 浏览 器 中 使 用 EJS。 
7.2.3 在 客户 端 程序 中 使 用 EJS 

要 在 客户 端 使 用 EJS， 首 先 要 把 EJS 引擎 下 载 到 工作 目录 中 ， 命 令 如 下 所 示 : 




















cd /your/working/directory 
curl -0O https://raw.githubusercontent.com/tj/ejs/master/lib/ejs.js 


下 载 完 就 可 以 在 客户 端 代码 中 使 用 EJS 了 。 下 面 是 一 个 简单 的 EJS 客户 端 程序 ， 将 它 存 为 
index.html1， 在 浏览 器 中 打开 看 看 效果 。 


代码 清单 7-7 用 EJS 给 客户 端 增加 使 用 模板 的 能 























<html> 
<head> 
<title>EJS example</title> 引入 jQuery 库 做 
<script src="ejs.js"></script> DOM 处 理 
<script < 
src="http://ajax.googleapis.com/ajax/libs/jquery/1.8/jquery.js"> 
</script> 
</head> 
<body> 用 来 泻 染 模板 输 
<div id="output"></div> < 一 出 的 占 位 标签 
<script> 泻 染 内 容 用 
const template = "<%= message %>"; < 的 模板 
用 在 模 const context = { message: 'Hello template!' }; 
板 中 的 $s(document) .ready (() => { 等 着 浏览 器 
数据 S$('#output ') .Ptml( 加 载 页 码 
ejs.render (template, context) < 一 一 


js 
2 


将 模板 泻 染 到 |D 为 
“output” 的 div 中 
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</script> 
</body> 
</html> 
学 完 这 个 功能 完备 的 Node 模板 引擎 ， 该 去 看 一 下 Hogan 模板 引 警 了， 它 特 意 限制 了 模板 代 
码 中 可 用 的 功能 。 


7.3 使 用 Mustache 模板 语言 与 Hogan 


Hogan.js 是 Twitter 为 满足 自己 的 需求 而 创建 的 模板 引擎。Hogan 是 Mustache 模板 语言 标准 
的 具体 实现 ， 这 一 标准 是 由 GitHub 的 Chris Wanstrath 创建 的 。 
跟 EJS 不 同 ，Mustache 遵循 极 简 主 义 ， 特 意 去 掉 了 条 件 逻 辑 。 在 内 容 过 滤 上 ，Mnustache 只 
为 防止 XSS 攻击 而 保留 了 转 义 处 理 功能 。Mustache 主张 模板 代码 应 该 尽 可 能 地 简单 。 
本 节 将 会 介绍 : 
口 如 何在 程序 中 创建 和 实现 Mustache 模板 ; 
口 Mustache 标准 中 的 各 种 模板 标签 ; 
口 如 何 用 子 模板 组 织 模板 ; 
口 如 何 用 定制 的 分 隔 符 和 其 他 选项 对 Hogan 进行 微调 。 
我 们 去 看 看 Hogan 提供 的 另 一 种 使 用 模板 的 方式 。 


7.3.1 创建 模板 


要 使 用 Hogan, 或 试验 本 节 的 例子 , 需要 在 程序 目录 中 ( ch07-templates/hogan-snippet ) 安装 
Hogan。 因 此 请 在 命令 行 中 输入 下 面 这 条 命令 : 

npm i --save hogan.js 

下 面 是 Hogan 使 用 简单 模板 演 染 上 下 文 的 简单 例子 。 运 行 后 会 输出 “Hello template!”。 


const hogan = require('hogan.js'); 

const templateSource = '{{message}}'; 

const context = { message: 'Hello template!' }; 
const template = hogan.compile(templateSource); 
console.log(template.render (context)); 


了 解 了 如 何 用 Hogan 处 理 Mustache 模板 后 ， 接 下 来 看 看 Mustache 支持 哪些 标签 。 




































































7.3.2 ”Moustache 标签 


Moustache 标签 在 概念 上 跟 EJS 的 标签 类 似 , 也 有 变量 值 的 占 位 符 , 指明 哪里 需要 循环 ,可 以 
增强 Mustache 的 功能 ， 在 模板 里 添加 注释 。 

1. 显示 简单 的 值 

在 Mustache 模板 中 ， 要 把 想 要 显示 的 上 下 文 名 称 放 在 双 大 括号 中 。 大 括号 在 Mustache 社区 
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里 被 称 为 胡须 。 比 如 说 ， 如 果 想 显示 上 下 文 项 name 的 值 ， 应 该 用 Hogan 标签 { {name}}。 
跟 大 多 数 模板 引擎 一 样 , Hogan 默认 也 会 对 内 容 进行 转 义 以 防范 XSS 攻击 。 如 果 要 在 Hogan 
中 显示 未 转 义 的 值 ， 既 可 以 把 上 下 文 项 的 名 称 放 在 三 条 胡须 中 ， 也 可 以 在 前 面 添 加 一 个 & 符号 。 
还 是 用 前 面 那 个 例子 , 你 可 以 用 {{ {name}}} 显 示 不 做 转 义 处 理 的 上 下 文 值 , 也 可 以 用 { {sname}}。 
如 果 想 在 Mustache 模板 中 添加 注释 ， 可 以 这 样 : {{! This is a comment }}。 
2. 区 块 : 多 个 值 的 循环 遍历 
尽管 Hogan 不 允许 在 模板 中 使 用 逻辑 ， 但 它 确实 引入 了 一 种 优雅 的 办 法 ， 可 以 用 Mustache 
区 块 对 上 下 文 项 中 的 多 个 值 做 循环 遍历 。 比 如 下 面 这 个 上 下 文中 的 数组 : 
const context = { 
students: [ 
{ name: 'Jane Narwhal', age: 21 }, 
{ name: 'Rick LaRue', age: 26 } 


] 
jy 


如 果 要 创建 一 个 模板 , 让 每 个 学 生 都 显示 在 单独 的 HTML 段落 中 ， 比 如 像 下 面 这 样 ，Hogan 
模板 可 以 轻松 实现 : 


<p>Name: Jane Narwhal, Age: 21 years old</p> 
<p>Name: Rick LaRue, Age: 26 years old</p> 


下 面 这 个 模板 能 生成 上 面 的 HTML: 


{{#students}} 
<p>Name: {{name}}, Age: {{age}} years old</p> 
{{/students}} 


3. 反 向 区 块 : 值 不 存在 时 的 默认 HTML 

如 果 上 下 文 数据 中 的 students 不 是 数组 会 怎么 样 9 比如 说 , 如 果 只 是 单个 对 象 , 那么 模板 
会 显示 这 个 对 象 。 但 如 果 是 undefined 或 false， 或 者 空 数 组 ， 则 什么 都 不 显示 。 

如 果 想 输出 消息 指明 该 区 块 的 值 不 存在 ， 那 么 可 以 用 Mustache 的 反 向 区 块 。 把 下 面 的 模板 
代码 加 到 前 面 那 个 显示 学 生 信息 的 模板 中 ， 上 下 文中 没有 数据 时 就 会 显示 这 条 消息 : 

{{^students}} 


<p>No students found.</p> 
{{/students}} 


4. 区 块 l ambda: 区 块 内 的 定制 功能 

如 果 Mustache 现 有 的 功能 无 法 满足 你 的 需求 ， 那 么 可 以 依据 Mustache 标准 自己 定义 区 块 标 
签 ， 让 它 调用 轴 数 处 理 模板 内 容 ， 不 用 循环 遍历 数组 。 这 被 称 为 区 块 lambda。 

代码 清单 7-8 是 用 区 块 lambda 支持 Markdown 的 例子 。 这 个 例子 用 到 了 github-flavored- 
markdown 模块 ， 在 命令 行 中 输入 npm install github-flavored-markdown --dev 安装 。 
如 果 你 用 的 是 随 书 源码 ， 则 在 ch07-templateylisting7 8 里 运行 npm install。 
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在 下 面 这 段 代 码 中 ,模板 中 的 **Namex* 传 给 由 区 块 lambda 调用 的 Markdown 解析 器 ， 生 成 
了 <strong>Name</strong>o 
代码 清单 7-8 在 Hogan 中 使 用 lambda 


const hogan = require('hogan.js'); A 
const md = require('github-flavored-markdown'); | 引入 Markdown 解析 器 








const templateSource = . 
大 类 大 大 。 

、 {{#markdown}}**Name**: {{name}}{{/markdown}} < Mustache 模板 中 也 包含 

; Markdown 格式 的 内 容 
const context = { 

name: 'Rick LaRue', 

markdown: () => text => md.parse (text) = 一 = 模板 上 下 文中 包含 一 个 
}s 解析 Markdown 的 区 块 
const template = hogan.compile(templateSource); lambda 
console.log(template.render (context)); 





使 用 区 块 lambda 可 以 在 模板 中 轻松 实现 缓存 和 转换 机 制 等 功能 。 

5. 子 模板 : 在 其 他 模板 中 重用 模板 

为 了 避免 多 个 模板 中 复制 粘贴 相同 的 代码 ， 可 以 将 这 些 通 用 的 代码 做 成 子 模板 〈partial )。 
子 模板 是 放 在 其 他 模板 内 的 构件 ， 可 以 把 复杂 的 模板 分 解 成 简单 模板 。 

比如 下 面 这 个 例子 ， 将 显示 学 生 数 据 的 代码 从 主 模板 中 分 离 出 来 做 成 了 子 模板 。 


代码 清单 7-9 在 Hogan 中 使 用 子 模板 




















const hogan = require('hogan.js'); 四 、 
const studentTemplate = 、 二 用 于 子 模 板 的 代码 
<p> 





ame: {{name}}, 
Age: {{age}} years old 
</p> 





主 模板 代码 


const mainTemplate = 、 
{{#students}} 
{{>student}} 
{{/students}} 


const context = { 
students: [{ 
name: 'Jane Narwhal', 
age: 21 
7 


name: 'Rick LaRue', 


age: 26 编译 主 模 板 
}] 和 子 模板 
} 
const template = hogan.compile(mainTemplate); < 泻 染 主 模 板 
const partial = hogan.compile(studentTemplate); 和 子 模板 
const html = template.render (context, {student: partial }); -== 


console.log (html); 


154 第 7 章 Web 程序 的 模板 





7.3.3 微调 Hogan 


Hogan 用 起 来 相当 简单 ,掌握 它 的 标签 汇总 表 就 够 了 。 在 使 用 时 可 能 只 有 一 两 个 地 方 需要 调 
整 一 下 。 

如 果 你 不 喜欢 Mustache 风格 的 大 括号 , 可 以 给 compile 方法 传人 一 个 参数 覆盖 Hogan 所 用 
的 分 隔 符 。 下 面 的 例子 把 EJS 风格 的 分 隔 符 编译 在 Hogan 中 : 


hogan.compile(text, { delimiters: '<% %$>' }); 


除了 Mustache， 还 有 其 他 模板 语言 。 比 如 想 把 HTML 的 噪声 都 去 掉 的 Pug。 


7.4 用 Pug 做 模板 


Pug， 以 前 叫 Jade， 它 用 另 一 种 方式 来 表示 HTML， 是 Express 的 默认 模板 引擎 。Pug 和 其 他 
主流 模板 系统 的 差别 主要 在 于 它 对 空格 的 使 用 。Pug 模板 用 缩 进 表示 HTML 标签 的 舱 入 关系 。 
HTML 标签 也 不 必 明 确 给 出 关闭 标签 , 从 而 避免 了 因为 过 早 关 闭 , 或 根本 就 不 关闭 标签 所 产生 的 
问题 。 由 于 有 严格 的 缩 进 规则 ， 因 此 Pug 模板 看 起 来 很 简洁 ， 更 易于 维护 。 

我 们 用 一 个 简短 的 示例 演示 一 下 ， 看 它 如 何 表示 这 段 HTML: 


<html> 
<head> 
<title>Welcome</title> 
</head> 
<body> 
<div id="main" class="content"> 
<strong>"Hello world!"</strong> 
</div> 
</body> 
</html> 


这 段 HTML 对 应 的 Pug 模板 如 下 所 示 : 


html 
head 
title Welcome 
body 
div.content#main 
strong "Hello world!" 


Pug 像 EJS 一 样 ， 可 以 能 入 JavaScript， 可 以 用 在 服务 器 端 或 客户 端 。 但 Pug 还 有 其 他 特性 ， 
比如 模板 继承 和 mixins。 用 mixins 可 以 定义 易于 重用 的 小 型 模板 ， 用 来 表示 常用 视觉 元 素 的 
HTML， 比 如 条 目 列表 和 盒子 。Mixins 很 像 我 们 上 一 节 介 绍 的 Hogan.js 子 模板 。 有 了 模板 继承 ， 
那些 把 一 个 HTML 页 面 泻 染 到 多 个 文件 中 的 Pug 模板 组 织 起 来 就 更 容易 了 。 我 们 稍 后 会 详细 介 
绍 。 输 入 下 面 这 条 命令 安装 Pug: 













































































npm install pug --save 
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本 节 将 会 介绍 : 

口 Pug 的 基础 知识 ， 比 如 说 明 类 名 、 属 性 和 块 扩展 ; 
口 如 何 用 内 置 的 关键 字 往 Pug 模板 里 添加 逻辑 ; 

口 如 何 用 继承 、 块 和 mixins 组 织 模板 。 

我 们 先 看 看 Pug 基本 的 语法 和 用 法 。 














7.4.1 Pug 基础 知识 


Pug 的 标签 名 跟 HTML 一样, 但 抛弃 了 前 面 的 < 和 后 面 的 > 字符 , 并 用 缩 进 表示 标签 的 垦 套 关 
系 。 标签 可 以 用 .<classname> 关 联 一 个 或 多 个 CSS 类。 比如 应 用 了 content 和 sidebar 类 的 div 
元 素 表 示 为 : 

div.content.sidebar 

在 标签 上 添加 #<ID> 可 以 赋予 它 CSS ID。 比 如 给 前 面 那个 例子 中 的 aiv 加 上 了 CSS ID 


featured content: 











div.content.sidebar#featured_ content 


aiv 标签 的 快捷 表示 法 
因为 HTML 中 经 常 使 用 div，Pug 定 义 了 它 的 快捷 表示 法 。 下 面 这 个 例子 泻 染 出 来 的 HIML 
和 前 面 那个 例子 一 样 : 


.Content.sidebar#featured_ content 





你 已 经 知道 如 何 表示 HTML 标签 、 它 们 的 CSS 类 和 ID 了 , 接 下 来 我 们 看 看 如 何 指 定 HTML 
标签 的 属性 。 

1. 指定 标签 的 属性 

将 标签 的 属性 放 在 括号 中 , 每 个 属性 之 间 用 逗号 分 开 。 下面 的 Pug 表示 一 个 会 在 新 的 浏览 
标签 中 打开 的 链接 : 


a(href='http://nodejs.org', target='_blank') 
为 带 属性 的 标签 可 能 会 很 长 , 所 以 Pug 在 处 理 这 样 的 标签 时 比较 灵活 。 比 如 下 面 这 种 表示 
跟前 面 那 个 效果 一 样 : 
a(href='http://nodejs.org', 
target='_blank') 
也 可 以 指定 不 需要 值 的 属性 。 下 面 这 段 Pug 示例 是 一 个 HTML 表单 , 其 中 包含 一 个 select 
元 素 ， 有 预先 选 定 option: 


strong Select your favorite food: 
form 
select 
option(value='Cheese') Cheese 
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option(value='Tofu', selected) Tofu 
Specifying tag content 


在 前 面 那 段 代 码 中 还 有 标签 内 容 的 示例 : strong 标签 后 面 的 Select your favorite 
food:; 第 一 个 option 后 面 的 Cheese; 第 二 个 option 后 面 的 Tofu。 

这 是 Pug 中 指定 标签 内 容 的 常用 办 法 , 但 不 是 唯一 的 。 尽管 这 种 风格 在 指定 比较 短 的 内 容 时 
很 好 用 , 但 如 果 标 签 的 内 容 很 长 ， 则 会 导致 Pug 模板 中 出 现 超 长 的 代码 行 。 不 过 ,就 像 下 面 这 个 
例子 一 样 ， 在 Pug 中 可 以 用 | 指定 标签 的 内 容 : 

textarea 

| This is some default text 


| that the user should be 
| provided with. 


如 果 HTML 标签 只 接受 文本 ( 即 不 能 能 入 HTML 元 素 ), 比如 style 和 script, 则 可 以 去 
掉 1 字 符 ， 像 下 面 这 样 : 


style. 
Hi 
font-size: 6em; 
Color: #9DFFOC; 
} 


用 两 种 办 法 分 别 表示 长 短 两 种 内 容 可 以 让 Pug 模板 保持 优雅 。 Pug 还 有 一 种 表示 髓 套 关系 的 
办 法 ， 即 块 扩展 。 

2. 用 块 扩展 把 它 组织 好 

Pug 一 般 用 缩 进 表 示 购 套 , 但 有 时 缩 进 形成 的 空格 太 多 了 。 比 如 下 面 这 个 用 缩 进 定义 链接 列 
表 的 Pug 模板 : 


















































ul 
1i 
a(href='http://nodejs.org/') Node.js homepage 
Ls 
a(href='http://npmjs.org/') NPM homepage 
1i 


a(href='http://nodebits.org/') Nodebits blog 


如 果 用 Pug 块 扩展 , 这 个 例子 会 更 紧凑 。 块 扩展 可 以 在 标签 后 面 用 冒号 表示 髋 套 。 下 面 这 段 
代码 生成 的 输出 跟前 面 的 一 样 ， 但 只 有 四 行 代 码 ， 而 前 面 那 段 代码 有 七 行 : 


ul 
11: a(href='http://nodejs.org/') Node.js homepage 
11: a(href='http://npmjs.org/') NPM homepage 
1i: a(href='http://nodebits.org/') Nodebits blog 














如 何 用 Pug 表示 标记 的 介绍 就 到 这 里 ， 接 下 来 我 们 要 看 一 下 如 何 把 Pug 集成 到 程序 中 。 

3. 将 数据 纳入 到 Pug 模板 中 

数据 传 给 Pug 引擎 的 方式 跟 EJS 一 样 。 模 板 先 被 编译 成 函数 ,然后 带 着 上 下 文 调用 它 ， 以便 
渲染 HTML 输出 。 如 下 例 所 示 : 
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const pug = require('pug'); 

const template = 'strong #{message}'; 

const context = { message: 'Hello template!' }; 
const fn = pug.compile(template); 
console.log(fn(context)); 


这 个 模板 中 的 #{message} 是 要 被 上 下 文 值 替 换 掉 的 占 位 符 。 
上 下 文 值 也 可 以 作为 属性 的 值 。 下 面 这 个 例子 会 演 染 出 <a nref="http://google.com"> 


</a>: 























const pug = require('pug'); 

const template = 'a(lhref = url)'; 

const context = { url: 'http://google.com' }; 
const fn = pug.compile(template); 
console.log(fn(context)); 


了 解 了 如 何 用 Pug 表示 HTML， 以 及 如 何 给 Pug 模板 提供 数据 ， 接 下 来 该 去 看 一 下 如 何在 
Pug 中 添加 逻辑 处 理 了 。 


7.4.2 ”Pug 模板 中 的 逻辑 


把 数据 交 给 模板 后 ,还 需要 定义 处 理 数据 的 逻辑 。 在 Pug 中 ,可 以 直接 在 模板 中 杏 入 JavaScript 
代码 来 定义 数据 处 理 逻 辑 。 像 if 语句 、for 循环 、var 声明 这 样 的 代码 都 很 常见 。 在 深入 讲解 
有 具体 细节 之 前 ， 来 看 个 用 Pug 模板 泻 染 通讯 录 的 例子 ， 先 对 如 何 使 用 Pug 逻辑 有 个 直观 的 感受 : 


h3.contacts-header My Contacts 
if contacts.length 
each contact in contacts 
- Var fullName = contact.firstName + ' ' + Contact.lastName 
.Contact-box 
p fullName 
if contact.isEditable 
p: a(href='/edit/+contact.id) Edit Record 
































p 
case contact.status 

when 'Active' 
strong User is active in the system 

when 'Inactive' 
em User is inactive 

when 'Pending' 
| User has a pending invitation 

else 
p You currently do not have any contacts 


下 面 来 看 一 下 Pug 模板 中 和 能 入 JavaScript 代码 时 如 何 处 理 输出 。 

1. 在 Pug 模板 中 使 用 JavaScript 

带 有 -前 缀 的 JavaScript 代码 的 返回 结果 不 会 出 现在 泻 染 结果 中 。 带 有 = 前 缀 的 JavaScript 代 
码 的 执行 结果 则 会 出 现 , 但 为 了 防止 XSS 攻击 做 了 转 义 处 理 。 如 果 JavaScript 代码 生成 的 内 容 不 
应 该 转 义 ， 那么 可 以 用 前 级 !=。 表 7-1 是 这 些 前 级 的 汇总 。 
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表 7-1 在 Pug 中 窝 入 JavaScript 的 前 组 
前 组 输 出 
到 转 义 的 输出 〈 用 于 不 可 信任 或 不 可 预测 的 值 ， 免 受 XSS 攻击 
不 做 转 义 处 理 的 输出 ( 用 于 可 信任 或 可 预测 的 值 ) 
- 没有 输出 








一 


























在 Pug 中, 有些 常用 的 条 件 判断 和 循环 语句 可 以 不 之前 级 : if、else、case、 when、default、 
until、 while、each 和 unless。 


Pug 中 还 可 以 定义 变量 。 下 面 两 种 赋值 方式 效果 是 一 样 的 : 


Seaunts = 0 
count = 0 


没有 前 级 的 语句 没有 输出 ， 就 像 前 面 说 的 -前 级 一 样 。 

2. 循环 遍历 对 象 和 数组 

Pug 中 的 JavaScript 可 以 访问 上 下 文中 的 值 。 在 下 面 这 个 例子 中 ,我 们 会 从 文件 中 读 取 一 个 
Pug 模板 ， 并 让 它 显 示 一 个 包含 两 条 消息 的 上 下 文 数组 : 


const pug = require('pug'); 
const fs = require('fs'); 
const template = fs.readFileSync('./template.pug'); 
const context = { messages: [ 
'You have logged in successfully.', 
'Welcome back!' 
J 
const fn = pug.compile(template); 
console.log(fn(context)); 


Pug 模板 中 的 内 容 如 下 所 示 : 


- messages.forEach (message => { 
p= message 


oe 
最 终 输出 的 HTML 是 : 






































<p>You have logged in successfully.</p><p>Welcome back!</p> 

Pug 中 还 有 一 个 非 JavaScript 形式 的 循环 each 语句。 用 each 语句 很 容易 实现 数组 和 对 象 
属性 的 循环 遍历 。 

下 面 这 段 代 码 跟前 面 的 例子 效果 一 样 ， 但 用 的 是 each: 


each message in messages 
p= message 


对 象 属性 的 循环 遍历 可 以 稍 有 不 同 ， 像 这 样 : 


each value, key in post 
div 
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strong #{key} 
p value 


3. 条 件 化 泻 染 的 模板 代码 
有 时 要 根据 数据 的 取 值 决定 如 何 显示 模板 。 下 面 是 个 条 件 判断 的 例子 ， 几 乎 有 一 半 的 可 能 会 
输出 script 标签 : 
- n = Math.round(Math.random() * 1) + 1 
-if (n == 1) { 
SCTLDE 


alert ('You win!'); 
ee 
条 件 判 断 在 Pug 中 还 有 一 种 更 简洁 的 写法 : 
- n = Math.round(Math.random() * 1) + 1 
iE 三 并 


SED 已 
alert ('You win!'); 


如 果 条 件 判 断 是 取 反 的 ， 比 如 if (n != 1)， 可 以 用 Pug 的 unless 关键 字 : 


- n = Math.round(Math.random() * 1) + 1 
unless n == 1 
总 GET 
alert('You win!'); 


4. 在 Pug 中 使 用 case 语句 

Pug 中 还 有 类 似 于 switch 的 非 JavaScript 条 件 判断 : case 语句 。case 语句 可 以 根据 模板 
的 场景 指定 输出 。 

在 下 面 这 个 例子 中 , 我 们 用 case 语句 以 三 种 不 同 的 方式 显示 博客 的 搜索 结果 。 如 果 没 有 结 
果 ， 则 显示 一 条 提示 消息 。 如 果 找 到 一 篇 ， 则 显示 它 的 详细 信息 。 如 果 找 到 很 多 篇 ， 则 用 each 
语句 循环 遍历 所 有 文章 ， 显 示 它 们 的 标题 : 


case results.length 






































when 0 

p No results found. 
when 1 

p= results[0] .content 
default 


each result in results 
p= result.title 


7.4.3 ”组织 Pug 模板 


模板 定义 好 后 ,要 知道 该 如 何 组 织 。 跟 程序 逻辑 一 样 ， 你 肯定 也 不 想 让 模板 文件 过 大 。 一 个 
模板 文件 应 该 对 应 一 个 构件 : 比如 一 个 页 面 ， 一 个 边栏 ， 或 者 一 篇 博客 文章 中 的 内 容 。 
本 节 会 介绍 几 种 机 制 ， 让 几 个 不 同 的 模板 文件 一 起 演 染 内 容 : 
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口 用 模板 继承 组 织 多 个 模板 文件 ; 
口 用 块 前 级 /追加 实现 布局 ; 
口 模板 包含 ; 
口 借助 mixins 重用 模板 逻辑 。 
我 们 先 从 Pug 的 模板 继承 开始 。 
1. 用 模板 继承 组 织 多 个 模板 文件 
模板 继承 是 多 个 模板 文件 的 结构 化 处 理 办 法 之 一 。 从 概念 上 来 讲 , 模板 就 像 面 向 对 象 编程 中 
的 类 。 一 个 模板 可 以 扩展 另 一 个 ， 然 后 这 个 再 扩展 另 一 个 。 只 要 合理 ， 使 用 多 少 层 继承 都 可 以 。 
这 里 有 个 小 例子 , 我 们 用 模板 继承 提供 一 个 简单 的 HTML 包装 器 , 可 以 用 来 包装 页 面 内 容 。 进 
和 人 工作 目录 ,创建 存放 Pug 文件 的 templates 目录 。 在 其 中 创建 模板 文件 layout.pug， 代 码 如 下 所 示 : 


html 
head 
block title 
body 
block content 


layout.pug 中 有 HTML 页 面 的 基本 定义 和 两 个 模板 块 。 模 板块 是 可 以 由 后 裔 模板 提供 内 容 的 
占 位 符 。layout.pug 的 后 裔 模板 可 以 在 title 模板 块 的 位 置 设 定 页 面 标题 ， 在 content 模板 块 
的 位 置 设 定 在 页 面 上 显示 什么 。 

接 下 来 在 template 中 创建 page.pug， 这 个 模板 会 提供 title 和 content 块 的 具体 内 容 : 

extends layout 

block title 

title Messages 
block content 


each message in messages 
p= message 


最 后 再 演示 一 下 继承 的 实际 用 法 , 将 本 节 前 面 的 例子 改 成 下 面 这 段 代 码 , 让 它 显 示 模 板 的 泻 


了 四 
染 结果 。 
























































代码 清单 7-10 模板 继承 实战 
const pug = require('pug'); 
const fs = require('fs'); 


const termplateFile = './templates/page.pug'; 
const iterTemplate = fs.readFileSync (templaterFile); 
const context = { messages: [ 


'You have logged in successfully.', 
'Welcome back!' 

3 

const iterFn = pug.compilel 
iterTemplate, 
{ filename: templateFile } 

); 

console.log(iterrFn (context)); 


接 下 来 我 们 要 介绍 模板 继承 的 另 一 个 特性 : 块 前 级 和 块 追 加 。 
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2. 用 块 前 缀 / 块 追加 实现 布局 
在 前 面 那 个 例子 中 ，layout.pug 中 的 模板 块 没有 内 容 ， 因 此 在 page.pug 模板 中 设 定 内 容 简单 


直接 。 如 果 被 继承 的 模板 中 有 内 容 ， 也 可 以 用 块 前 级 和 块 追 加 ， 在 原 有 内 容 基 础 上 构建 新 内 容 ， 


而 不 是 替换 它 。 
下 面 的 layout.pug 模板 中 增加 了 一 个 模板 块 scripts， 其 中 有 加 载 jQuery 的 script 标签 : 











html 

head 
- Const baseUrl = 
block title 
block style 
block scripts 

body 
block content 


如 果 还 想 让 page.pug 再 加 上 jQuery UI 库 ， 可 以 用 下 面 的 模板 。 


"http://ajax.googleapis.com/ajax/libs/jqueryui/1.8/" 


代码 清单 7-11 用 块 追加 再 加 载 一 个 JavaScript 文件 
extends layout < 这 个 模板 扩展 了 
baseUrl = "http://ajax.googleapis.com/ajax/libs/jqueryui/1.8/" layout 模板 


block title 

title Messages : 
定义 style 块 
block style < 


link(rel="stylesheet", href= baseUrl+"themes/flick/jquery-ui.css") 


block append scripts < SA 
script (src= baseUrl+"jquery-ui.js") 把 这 1 scripts 块 追加 到 
layout 中 定义 的 那个 上 面 


block content 
count: = "0 
each message in messages 
- Count = count + 1 
GO 
$s(function() { 
$s("#message _#{count}") .dialog(t{ 
height: 140, 
modal: true 
es 


}); 
' + message + '</div>' 


I!= '<div id="message_' + Count + '"> 
但 模板 继承 不 是 唯一 一 种 集成 多 个 模板 的 办 法 。 也 可 以 用 include Pug 命令 。 
3. 模板 包含 

















Pug 中 的 incluae 命令 是 另 一 个 组 织 模板 的 工具 。 这 个 命令 会 引入 另 一 个 模板 中 的 内 容 。 
如 果 在 前 面 那个 layout.pug 里 加 一 行 includqe footer， 最 终 就 会 得 到 下 面 这 个 模版 : 
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html 
head 
block title 
block style 
block scripts 
script (src='//ajax.googleapis.com/ajax/libs/jquery/1.8/jquery 
body 
block content 
include footer 


.js') 


这 个 模版 会 在 layout.pug 的 演 染 输出 中 引入 footerpug 中 的 内 容 ， 如 图 7-3 所 示 。 








layout.jade 


include 

















图 7-3 Pug 的 include 机 制 是 在 泻 染 一 个 模板 时 包含 男 一 个 模板 内 容 的 简单 办 法 





可 以 用 include 往 layout.pug 中 添加 关于 网 站 的 信息 或 设计 元 素 。 也 可 以 指定 文件 的 扩展 


名 ,包含 非 Pug 文 件 (比如 include twitter_widget.html )。 
4. 借助 mixin 重用 模板 逻辑 








尽管 Pug 的 include 命令 能 帮 有 我 们 引入 之 前 创建 的 代码 块 ， 但 要 构建 在 程 





E 序 和 不 同 页 面 之 


间 共 享 的 可 重用 功能 库 时 , 它 就 玫 不 上 什么 忙 了 。Pug 为 此 专门 提供 了 mixin 命令 , 可 以 用 来 定 


义 可 重用 的 Pug 代码 块 。 


























mixin 模拟 的 是 JavaScript 函数 。 它 跟 函 数 一 样 , 可 以 带 参 数 , 并 且 这 些 参 数 可 以 用 来 生成 Pug 


代码 [2 
比如 说 要 处 理 下 面 这 种 数据 结构 : 


const students = [ 
{ name: 'Rick LaRue', age: 23 }, 
{ name: 'Sarah Cathands', age: 25 }, 
{ name: 'Bob Dobbs', age: 37 } 

] 





如 果 要 把 从 对 象 中 提取 出 来 的 属性 输出 到 HIML 列表 里 ， 那 么 可 以 像 下 面 这 样 定义 一 个 mixin: 


mixin list_object_property (objects, property) 
ul 
each object in objects 
1i= object [property] 


Ck 
ANNS 
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然后 就 可 以 像 下 面 这 样 借助 mixin 显示 这 些 数据 : 

mixin list_object_property (students, 'name') 

背 助 模板 继承 、incluae 语句 和 mixin， 你 可 以 轻松 地 重用 展示 标记 ， 防 止 模板 文件 变 得 
过 于 宛 长 。 








7.5 总 结 











口 模板 引擎 可 以 把 程序 逻辑 和 展示 组 织 好 。 

口 EJS、Hogan.js 和 Pug 都 是 Node 中 比较 流行 的 模板 引擎 。 

口 EJS 支持 简单 的 流程 控制 ， 以 及 转 义 或 非 转 义 插值 。 

口 Hogan.js 是 简单 的 模板 引擎 ， 不 支持 流程 控制 ， 但 支持 Mustache 标准 。 
口 Pug 是 比较 复杂 的 模板 语言 ， 可 以 输出 HTML， 但 不 用 人 尖 括 号 。 

口 Pug 用 空格 表示 标签 的 能 套 关系 。 
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本 章 内 容 

口 关系 型 数据 库 : PostgreSQL 
口 非 关 系 型 数据 库 : MongoDB 
口 ACID 类 

口 云 数据 库 和 存储 服务 


Nodejs 的 应 用 范围 非常 广泛 ， 可 以 满足 开发 人 员 各 种 各 样 的 需求 。 没 有 哪个 数据 库 或 存储 
案 能 够 独立 应 对 Node 所 面 对 的 各 种 应 用 场景 。 本 章 不 仅 会 对 各 种 可 能 的 数据 存储 做 个 概述 ， 
还 会 介绍 一 些 重要 的 概念 和 术语 。 


8.1 关系 型 数据 库 


长 期 以 来 ， 关 系 型 数据 库 都 是 Web 程序 存储 数据 的 不 二 之 选 。 因 为 关于 这 个 话题 的 讨论 太 
多 了 ， 所 以 本 章 不 会 在 这 上 面 多 费 口舌 。 

关系 型 数据 库 以 关系 代数 和 集合 论 为 理论 基础 ,诞生 于 20 世纪 70 年 代 。 用 模式 指定 各 种 数 
据 类 型 的 格式 和 这 些 数据 类 型 之 间 的 关系 。 比 如 说 ， 做 社交 网 络 时 会 有 User 和 Post 类 型 ， 它 
们 之 间 还 会 有 一 对 多 的 关系 。 然 后 用 结构 化 查询 语言 (SQL ) 发 起 数据 查询 ， 比 如 “给 我 ID 为 
123 的 用 户 名 下 的 所 有 帖子 ”用 SQL 表示 就 是 : SELECT * FROM post WHERE user_id=123。 


8.2 ” PostgreSQL 


在 Node 程序 中 ，MySQL 和 PostgreSQL ( Postgres ) 都 是 常用 的 关系 型 数据 库 。 其 实 选择 哪 
个 关系 型 数据 库 主要 看 个 人 偏好 ， 所 以 本 节 大 部 分 内 容 也 适用 于 其 他 关系 型 数据 库 ， 比 如 
MySQL。 我 们 先 看 一 下 如 何在 开发 环境 中 安装 Postgres。 


8.2.1 安装 及 配置 


Postgres 的 安装 不 是 执行 一 条 npm 命令 那么 简单 。 不 同 平台 上 的 安装 是 不 一 样 的 。macOS 上 
很 简单 ， 只 要 : 






















































































8.2 PostgreSQL 165 





brew update 
brew install postgres 


如 果 之 前 安装 过 , 可 能 会 碰 到 升级 问题 。 你 可 以 参照 所 用 平台 的 指南 把 原来 的 数据 库 迁 移 一 
下 , 或 者 直接 抹 掉 数据 库 目录 : 


# WARNING: will delete existing postgres configuration & data 
rm -rf /usr/local/var/postgres 


然后 初始 化 并 启动 Postgres: 


initdb -D /usr/local/var/postgres 
pg_ctl -D /usr/local/var/postgres -1 logfile start 


这 会 启动 Postgres 守护 进程 ， 不 过 每 次 重启 机 器 都 要 重新 启动 这 个 进程 。 如 果 嫌 这 样 麻烦 ， 
可 以 找 一 下 在 线 教程 有 很 多 教程 是 讲 如 何在 机 器 启动 时 自动 启动 Postgres 守护 进程 的 。 

同样 ， 很 多 Linux 系统 也 有 安装 包 。 至 于 Windows， 要 从 postgresql.org 上 下 载 安装 大 。 

Postgres 有 几 个 命令 行 管 理工 具 ， 可 以 用 man 命令 看 一 下 它们 各 自 的 帮助 手册 了 解 详 情 。 


8.2.2 ”创建 数据 库 

Postgres 守护 进程 跑 起 来 后 就 可 以 创建 要 用 的 库 了 。 数 据 库 只 需要 创建 一 次 ， 最 简单 的 办 法 
是 用 命令 createdb。 下 面 这 条 命令 创建 了 一 个 名 为 articles 的 库 : 

createdb articles 

如 果 成 功 就 不 会 有 输出 。 如 果 已 经 有 同名 数据 库 了 ， 则 什么 也 不 做 ， 只 是 提示 创建 失败 。 

尽管 可 以 根据 数据 库 的 运行 环境 配置 成 连接 多 个 数据 库 ， 但 大 多 数 程序 一 次 只 会 连接 一 个 。 
它们 至 少 会 有 两 个 环境 : 开发 和 生产 。 

要 删 掉 已 有 数据 库 中 的 全 部 数据 ， 可 以 用 aropab 命令 ， 参 数 是 数据 库 名 : 

dropdb articles 


如 果 想 再 用 这 个 库 ， 需 要 再 次 执行 createdb。 


















































8.2.3 从 Node 中 连接 Postgres 


在 Node 中 与 Postgres 交互 ， 最 受 欢 迎 的 包 就 是 pg。 可 以 用 npm 安装 : 

npm install pg --save 

Postgres 服务 器 跑 起 来 了 ， 数 据 库 创建 好 了 ，pg 包 也 安装 上 上 了， 那么 现在 可 以 在 Node 里 使 
用 这 个 数据 库 了 。 在 给 服务 器 发 送 命令 之 前 ， 还 需要 建立 数据 库 连 接 ， 如 下 所 示 。 
代码 清单 8-1 连接 数据 库 


const pg 
const db 








require('pg'); 
new pg.Client ({ database: 'articles' }); 了 <4 一 配置 连 


. 接 参数 
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db.connect ((err, client) => { 
if (err) throw err; 、 人 
console.log('Connected to database', db.database); 关闭 数据 库 连接 ， 
db.end(); 过 二 一， Node 进程 可 以 退出 
} 3 


pg 包 在 GitHub 的 wiki 页 面 上 有 pg.client 及 其 他 方法 的 详细 介绍 。 
8.2.4 定义 表 


要 在 PostgreSQL 中 存储 数据 ， 首 先 要 像 下 面 这 样 定义 表 ， 确 定 表 中 存储 的 数据 形态 〈 随 书 
源码 见 ch08-databases/listing8 3 )。 


代码 清单 8-2 ”定义 模式 
db.gquery(. 
CREATE TABLE IF NOT EXISTS snippets ( 
id SERIAL, 
PRIMARY KEY (id), 
body text 
js 
(err, result) => { 
if (err) throw err; 
console.log('Created table "snippets"'); 
db.end(); 
和 学 





8.2.5 插入 数据 


表 定 义 好 后 ， 可 以 像 下 面 这 样 用 INSERT 查询 插入 数据 。 如 果 不 指定 1da，PostgreSQL 会 自 
动 生 成 一 个 。 要 想 知道 生成 的 ID 是 什么 ， 需 要 在 查询 话 句 里 加 上 RETURNING id， 然 后 可 以 在 
回调 函数 的 结果 集 参 数 中 得 到 id 值 。 


代码 清单 8-3 ”插入 数据 





























const body = 'hello world'; 
db.aquery(. 
INSERT INTO snippets (body) VALUES ( 
'$ {body}' 


) 
RETURNING id 
e (err, result) => { 
if (err) throw err; 
const id = result.rows[0].iqd; 
console.log('Inserted row with id %s', id); 


他 


8.2.6 更 新 数据 
插入 数据 后 , 可 以 像 下 面 这 样 用 UPDATE 查询 更 新 数据 。 受 影响 的 记录 数 放 在 查询 结果 中 的 
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rowCount 属性 上 。 完 整 随 书 源码 见 ch08-databases/listing8_4。 


代码 清单 8-4 ”更 新 数据 


GONnst. Ld 13 
const body = 'greetings, world'; 
db.query(. 
UPDATE snippets SET (body) = ( 
'$ {body}' 
) WHERE id=$ {id}; 
(err, result) => { 
if (err) throw err; 
console.log('Updated %s rows.', result.rowCount); 


} 


8.2.7 ”查询 数据 


关系 型 数据 库 的 能 量 主 要 体现 在 复杂 的 数据 查询 上 。 查 询 语 句 用 的 是 SELECT， 下 面 这 种 是 
最 简单 的 。 


代码 清单 8-5 ”查询 数据 








db.gquery(. 
SELECT * FROM snippets ORDER BY id 
(err, result) => { 


if (err) throw err; 
console.log(result.rows); 


ee 


8.3 Knex 


很 多 开发 人 员 都 不 喜欢 把 SQL 直接 放 在 代码 里 ,希望 能 有 个 抽象 层 隔离 一 下 。 因 为 用 字符 
串 拼接 SQL 语句 太 繁 琐 了 ， 而 且 那 些 查询 可 能 会 变 得 越 来 越 难以 理解 和 维护 。 对 于 JavaScript 
来 说 更 是 如 此 , 因为 在 ES2015 的 模板 常量 出 来 之 前 , 它 连 表示 多 行 字符 串 的 语法 都 没有 。 图 8-1 
是 Knex 的 统计 数据 ， 其 中 有 下 载 次 数 ， 由 此 可 见 它 是 多 么 受 欢迎 。 




















npm install knex 
16 dependencies version 0.11.7 


278 dependents updated 19 days ago 
136,177 downloads in the last month 
download rank: top 1% of 296,000 packages 


图 8-1 Knex 的 使 用 统计 


Knex 是 一 个 轻便 的 SQL 抽象 包 ， 它 被 称 为 查询 构建 器 。 我 们 可 以 通过 查询 构建 器 的 声明 式 
API 构造 出 SQL 字符 串 ，Kenx 的 API 人 简单 直 白 : 
knex({ client: 'mysql' }) 


.Select () 
.from('users') 
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.where({ id: '123' }) 


SET 
这 段 代 码 会 生成 一 个 MySQL 的 参数 化 SQL 查询 : 
select * from ‘users. where “id = ? 


8.3.1 查询 构建 器 


尽管 业界 在 20 世纪 80 年 代 中 期 就 已 经 确立 了 ANSI 和 ISO SQL 标准 ,不 过 直到 现在 ， 大 多 
数 数据 库 用 的 仍然 是 自己 的 SQL 方言 。 但 PostgreSQL 是 个 例外 ， 它 遵循 了 SQL:2008 标准 ， 这 
种 选择 极其 难能可贵 ， 值 得 尊敬 。 查 询 构建 器 能 在 支持 多 种 数据 库 的 同时 消除 各 种 SQL 方言 的 
差异 ， 提 供 一 个 统一 的 SQL 生成 接口 。 对 于 经 常 要 在 不 同 的 数据 库 技术 之 间 进 行 切换 的 团队 来 
说 ， 查 询 构 建 器 提供 的 好 处 不 言 而 喻 。 

Knex.js 支持 的 数据 库 有 : 
DQ PostgreSQL 
DO MSSQL 
D MySQL 
口 MariaDB 
口 SQLite3 
口 Oracle 
表 8-1 列 出 了 Knex 为 不 同 数据 库 生 成 的 插入 语句 。 


表 8-1 Knex 为 不 同 数据 库 生 成 的 SQL 





















































数 据 库 SQL 
PostgreSQL 、SQLite 和 Oracle insert into "users" ("name","age") values(?,?) 
MySQL 和 MariaDB insert into ‘users. (name ` ‘age') values(?,?) 
Microsoft SQL Server insert into [users] ([name], [age]l) values(?,?) 


Knex 支持 promise 和 Node 风格 的 回调 。 


8.3.2 ”用 Knex 实现 连接 和 查询 
Knex 不 像 其 他 查询 构建 器 ， 它 还 可 以 根据 选 定 的 数据 库 驱 动 连 接 数 据 库 并 执行 查询 语句 : 


db('articles') 
.Select ('title') 
.where({ title: 'Today’'s News' }) 
.then(articles => { 
console.log(articles); 


2 


Knex 查询 默认 返回 promise, 但 也 提供 了 .ascallback 方法 , 可 以 依照 惯例 支持 回调 函数 : 
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db('articles') 
.Select ('title') 
.where({ title: 'Today’'s News' }) 
.asCallback( (err, articles) => { 
if (err) throw err; 
console.log(articles); 
J 





上 Knex。 先 安装 knex 和 sqlite3 包 : 


npm install knex@~0.12.0 sqlite3@~3.1.0 --save 


第 3 章 用 到 SQLite 时 ， 是 直接 跟 sqlite3 包 交 互 的 。 接 下 来 我 们 要 重 写 那 个 例子 ， 这 次 要 用 


下 面 的 代码 用 sqlite3 实现 了 简单 的 Article 模型 。 将 它 保存 为 db.js， 稍 后 在 代码 清单 8-7 





中 将 用 它 跟 数据 库 交 互 。 
代码 清单 8-6 ”用 Knex 连接 sqlite3 并 进行 查询 


const knex = require('knex'); 


const db = knex({ 
client: 'sqlite3', 
connection: { 
filename: 'tldr.sqlite' 


}, 在 改变 后 端 时 将 它 
useNullAsDefault: true 4 设 为 默认 更 有 效 
2 
module.exports = () => { 


return db.schema.createTableIfNotExists('articles', table => { 
table.increments('id') .primary (); 
table.string('title'); 
table.text ('content'); 定义 插入 时 自 
2 增长 的 主键 “id” 
1 


module.exports.Article = { 
EL) 水 
return db('articles') .orderBy ('title'); 
} 


find(id) { 


return dbl('articles') .where({ id }).first(); 


create(data) { 
return db('articles').insert (data); 


delete(id) { 
return db('articles').del() .wherel({ id }); 
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现在 可 以 用 ab.aArticle 添加 Article 记录 了 。 下 面 这 段 代码 是 用 来 创建 article 的 ， 


并 会 输出 全 部 文章 。 完 整 随 书 源码 见 ch08-databases/listing8_7/index.js。 


代码 清单 8-7 ”与 用 Knex 实现 的 API 交互 
db().then(() => { 
db.Article.createl(l{ 
title: 'my article', 
content: 'article content' 
) Ehenm(t() es 
db.Article.all() .then(articles => { 
console.log(articles); 
process.exit (); 
上 
}); 
}) 


.Catch(err => { throw err }); 


SQLite 几乎 不 需要 配置 : 不 用 启动 服务 器 守护 进程 ， 也 不 用 在 程序 外 面 创 建 数据 库 。SQLite 
把 所 有 东西 都 写 到 一 个 文件 里 。 运 行 前 面 的 代码 后 ， 当 前 目录 下 会 有 个 articles.sqlite 文件 。 删 掉 














这 个 文件 就 能 把 这 个 数据 库 抹 掉 : 


rm articles.sqlite 





SQLite 还 有 内 存 模式 ,完全 不 用 往 硬 盘 里 写 东 西 。 在 进行 自动 化 测试 时 , 一 般 会 用 这 种 模式 





降低 运行 时 间 。 带 有 :memory :的 特殊 文件 名 会 启用 内 存 模 式 。 在 启用 内 存 模 式 后 ， 妇 
连接 ， 那 么 每 个 连接 都 会 有 自己 的 私有 数据 库 : 


const db = knex({ 
client: 'sqlite3', 
connection: { 
filename: ':memory:' 
ks 
useNullAsDefault: true 


}); 





8.3.3 切换 数据 库 


1 果 有 多 个 


因为 用 了 Knex， 所 以 要 把 代码 清单 8-6 和 代码 清单 8-7 换 成 使 用 PostgreSQL 很 容易 。 
跟 PostgreSQL 服务 器 交互 需要 用 到 pg 包 ， 要 将 其 安装 好 并 跑 起 来 。 把 pg 包 安 装 到 代码 清单 8-7 
( 随 书 源码 见 ch08-databases/listing8 7 ) 所 在 的 目录 中 ， 别 忘 了 用 PostgreSQL 的 createdp 命令 








创建 相应 的 数据 库 : 


npm install pg --save 
createdb articles 


只 要 修改 Knex 的 配置 就 能 换 成 这 个 新 数据 库 。 对 外 的 API 和 使 用 还 是 一 样 的 : 


const db = knex({ 
CGI Co. 
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connection: { 
database: 'articles' 
}: 
} 


不 过 在 现实 中 ， 还 要 迁移 数据 库 。 


8.3.4 注意 抽象 漏洞 

查询 构建 器 能 对 SQL 语法 做 标准 化 处 理 ， 但 改变 不 了 数据 库 的 行为 。 有 些 特 性 只 有 特定 数 
据 库 提供 支持 ， 而 且 对 于 同样 的 查询 , 不 同 的 数据 库 可 能 会 作出 不 同 的 行为 。 比 如 下 面 这 两 个 定 
义 主键 的 方法 : 


DD table.increments('id') .primary (); 

















D table.integer('id') .primary (); 
在 SQLite3 上 都 没 问 题 ， 但 在 PostgreSQL 上 插入 记录 时 ， 第 二 个 会 出 错 : 
"null value in column "id" violates not-null constraint" 
在 SQLite 上 ， 如 果 插 入 的 记录 主键 为 null， 不 管 是 否 配 置 为 自 增 长 主键 ， 都 会 自动 赋 给 
它 一 个 自 增 长 的 ID 。 而 PostgreSQL 只 有 主键 显 式 定 义 为 自 增长 主键 时 才 会 如 此 处 理 。 这样 的 行 
为 差异 很 多 ， 并 且 有 些 差异 导致 的 错误 可 能 无 法 轻易 发 现 。 如 果 换 数据 库 ， 一 定 要 进行 充分 地 
测试 。 









































8.4 MySQL 和 PostgreSQL 


MySQL 和 PostgreSQL 都 是 成 熟 高 效 的 数据 库 系 统 ， 并 且 对 于 很 多 项 目 来 说 ,它们 两 个 几乎 
没什么 差别 。 直 到 项 目 需要 扩张 时 ， 开 发 人 员 才 会 感觉 到 它们 在 接口 边缘 或 接口 之 下 的 差异 。 
要 详尽 地 列 出 两 个 关系 型 数据 库 之 间 的 差别 是 件 比较 复杂 的 事情 , 所 以 我 们 这 里 只 会 给 出 一 
些 值得 注意 的 差别 : 
口 PostgreSQL 支持 一 些 表达 能 力 更 强 的 数据 类 型 ， 比 如 数组 、JSON 和 用 户 定 义 的 类 型 ; 
口 PostgreSQL 自 带 全 文 搜索 功能 ; 
口 PostgreSQL 全 面 支持 ANSI SQL:2008 标准 ; 
口 PostgreSQL 的 复制 功能 不 如 MySQL 强大 ， 或 者 说 没有 经 受过 那么 严 苛 的 考验 ; 
口 MySQL 资历 更 老 、 社 区 更 大 ， 有 更 多 的 工具 和 资源 ; 
口 MySQL 有 很 多 有 微妙 差别 的 分 支 ( 比如 MariaDB 和 WebScaleSQL 这 些 受到 Facebook、 
Google 、Twitter 等 公司 支持 的 版 本 ); 
口 MySQL 的 可 插 拔 存储 引擎 不 太 好 理解 , 管理 和 调 优 也 有 一 定 的 难度 。 不 过 换个 角度 来 看 ， 
这 也 意味 着 可 以 对 它 的 性 能 做 更 精细 的 控制 。 
MySQL 和 PostgreSQL 在 规模 变 大 后 会 表现 出 不 同 的 性 能 特点 , 这 要 取决 于 它们 要 人 处理 哪 种 
工作 负载 。 但 可 能 只 有 等 到 项 目 成 熟 之 后 ， 工 作 负 载 的 类 型 才 会 显现 出 来 。 
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对 于 各 种 关系 型 数据 库 的 比较 ， 网 上 有 很 多 深入 细致 的 资料 可 供 参 考 。 
口 www.digitalocean.com/community/tutorials/sqlite-vs-mysql-vs-postgresql-a-comparison-of- 
relational-database-management-systems 


口 https://blog.udemy.com/mysql-vs-postgresqgl/ 





口 https://eng.uber.com/mysql-migration/ 

选 哪个 数据 库 并 不 会 影响 项 目 成 功 与 否 ,所 以 不 要 在 这 个 问题 上 纠结 。 如 果 有 必要 ， 以 后 也 
可 以 做 数据 库 迁 移 ， 但 PostgreSQL 应 该 足以 满足 你 对 功能 特性 和 扩展 能 力 的 需求 。 但 如 果 你 恰 
好 要 对 数据 库 的 评估 选 型 负责 ， 则 有 必要 熟悉 一 下 ACID 保证 。 



































8.5 ACID 保证 


ACID" 是 对 数据 库 事务 的 一 组 要 求 : 原子 性 、 一 致 性 、 隔 离 性 和 耐用 性 。 这 些 术语 的 确切 定 
义 可 能 会 变 。 但 一 般 来 说 ， 系 统 对 ACID 保证 越 严 格 ， 在 性 能 上 作出 的 让 步 就 越 大 。 开 发 人 员 用 
ACID 分 类 来 交流 不 同方 案 所 做 的 妥协 ， 比 如 在 聊 NoSQL 系统 时 。 


8.5.1 原子 性 : 无 论 成 败 ， 事 务必 须 整 体 执行 


原子 性 事务 不 能 被 部 分 执行 : 或 者 整个 操作 都 完成 了 ,或 者 数据 库 保 持原 样 。 比 如 说 要 删除 
某 个 用 户 的 所 有 评论 ， 如 果 作为 一 个 事务 的 话 ， 或 者 全 都 删 掉 了 ， 或 者 一 条 也 没 删 。 最 终 不 能 是 
有 些 删 控 了 ， 有些 还 保持 原来 的 状态 。 其 至 在 系统 出 错 或 断 电 后 ,仍然 要 保证 原子 性 。 原 子 性 在 
这 里 的 意思 是 不 可 再 分 。 


8.5.2 一 致 性 : 始终 确保 约束 条 件 


成 功 完成 的 事务 必须 符合 系统 中 定义 的 所 有 数据 完整 性 约束 。 比 如 主键 必须 唯一 、 数 据 要 符 
合 某 种 特定 的 模式 , 或 者 外 键 必须 指向 存在 的 实体 。 产 生 不 一 致 状态 的 事务 一 般 也 会 失败 ,然而 
小 问题 是 可 以 自动 解决 的 ， 比 如 将 数据 转换 成 正确 的 形态 。 不 要 把 一 致 性 ( Consistency ) 的 C 跟 
CAP 定理 中 的 C 搞 混 了 ,那个 C 是 指 在 读 取 分 布 式 存储 的 数据 时 ， 确 保 呈 现 的 是 一 个 视图 。 


8.5.3 ”隔离 性 : 并 发 事务 不 会 相互 干扰 


不 管 是 并 发 还 是 线性 执行 ,隔离 性 事务 的 执行 结果 应 该 都 是 一 样 的 。 系 统 的 隔离 水 平 会 直接 
影响 它 执行 并 发 操作 的 能 力 。 全 局 锁 是 一 种 比较 低 幼 的 隔离 方式 , 由 于 在 事务 期 间 会 把 整个 数据 
库 锁 住 ， 所 以 只 能 串 行 处 理事 务 。 这 是 很 强 的 隔离 性 保证 , 但 效率 也 极 低 : 那些 跟 事务 完全 没有 
关联 的 数据 集 根 本 不 应 该 被 锁 住 ( 比如 说 , 一 个 用 户 添 加 评论 时 不 应 该 导致 为 一 个 用 户 无 法 更 新 
己 的 个 人 资料 )。 在 现实 情况 中 ， 数 据 库 系 统 会 提供 更 加 精细 的 和 有 选择 性 的 锁 模 式 ( 比如 锁 
表 、 锁 记录 或 锁 数据 域 )， 以 实现 各 种 程度 的 隔离 水 平 。 更 复杂 的 系统 甚至 可 能 会 采用 隔离 水 平 
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J 原子 性 ( Atomicity )、 一 致 性 ( Consistency )、 隔 离 性 ( Isolation ) 和 耐用 性 (Durability ) 的 缩写 。 
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最 低 的 锁 模 式 ， 乐 观 地 并 行 执行 所 有 事务 ， 直 到 检测 到 冲突 时 才 会 逐步 细 化 锁 模 式 。 


8.5.4 耐用 性 : 事务 是 永久 性 的 


事务 的 耐用 性 是 对 持久 化 生效 的 保证 ,在 重启 、 断 电 、 系 统 错误 甚至 硬件 失效 的 情况 下 ,， 持 
久 化 的 效果 依然 不 受 影 响 。 比 如 SQLite 内 存 模式 下 的 事务 就 没有 耐用 性 ， 进 程 退 出 后 所 有 数据 
都 没 了 。 而 在 SQLite 把 数据 写 到 硬盘 中 时 ， 事 务 的 耐用 性 就 很 好 ， 因 为 机 器 重启 后 数据 还 在 。 

这 看 起 来 好 像 很 简单 : 只 要 把 数据 写 到 人 硬盘 里 就 好 了 ， 事 务 就 有 耐用 性 了 。 但 硬盘 IO 是 比 
较 慢 的 操作 ， 即 便 程序 规模 增长 比较 温和 时 ，LIO 操作 也 会 迅速 变 成 性 能 瓶 陆 。 为 了 保证 系统 性 
能 ， 有 些 数据 库 会 提供 不 同 的 耐用 性 折 中 方案 。 


8.6 NoSQL 


非 关系 模型 的 数据 存储 统称 为 NoSQL。 因 为 现在 有 些 NoSQL 数据 库 确 实 支持 SQL， 所 以 
NoSQL 的 含义 更 接近 于 非 关 系 型 ， 或 者 被 当 作 不 仅 是 SQL 的 缩写 。 

下 面 举 一 些 NoSQL 的 范式 及 相应 的 数据 库 的 例子 : 

口 键 - 值 /元 组 存储 一 DynamoDB、LevelDB、Redis、etcd、Riak、Aerospike、Berkeley DB; 
口 图 存储 一 一 Neo4J、OrientDB ; 

口 文档 存储 一 一 CouchDB、MongoDB、Elastic( 以 前 的 Elasticsearch ); 

口 列 存储 Cassandra、 HBase; 

口 时 间 序 列 存储 一 一 Graphite 、InfluxDB、RRDtool; 

口 多 范式 一 一 Couchbase( 文档 数据 库 、 键 / 值 存储 、 分 布 式 缓存 )。 

NoSQL 官网 上 有 更 完整 的 NoSQL 数据 库 列表 。 

如 果 你 只 用 过 关系 型 数据 库 , 可 能 不 太 容 易 接受 NoSQL 的 概念 , 因为 NoSQL 的 用 法 经 常会 
违反 你 已 经 习惯 了 的 最 佳 实践 : 没有 模式 定义 、 重 复 的 数据 、 松 散 的 强制 性 约束 。NoSQL 系统 
经 常会 将 赋予 数据 库 的 责任 放 到 应 用 程序 上 。 这 看 起 来 可 能 会 很 乱 。 

一 般 情 况 下 ,只 要 一 小 部 分 访问 模式 就 会 创建 大 量 的 数据 库 工作 负载 ， 比 如 生成 程序 登录 画 
面 的 查询 , 需要 获取 很 多 域 对 象 。 在 关系 型 数据 库 中 ， 要 提高 读 取 性 能 时 一 般 会 做 非 规 范 化 ,给 
客户 端的 域 查询 要 经 过 预 处 理 并 形成 可 以 降低 查询 次 数 的 形态 。 

一 般 来 说 ，NoSQL 数据 默认 就 是 非 规范 化 的 ， 其 至 会 跳 过 域 建 模 。 这 样 就 不 会 在 数据 模型 
上 做 过 多 工作 ， 修 改 起 来 会 更 迅速 ， 并 形成 更 简单 、 更 好 执行 的 设计 。 
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程序 可 以 在 垂直 和 水 平 两 个 方向 上 扩展 , 垂直 扩展 是 指 增加 机 器 的 能 力 , 水 平 扩展 是 指 增加 
机 器 的 数量 。 垂 直 扩 展 一 般 更 简单 ， 但 会 受 限 于 一 台 机 器 所 能 达到 的 硬件 水 平 ， 而 且 成 本 上 升 很 
快 。 相 对 来 说 , 水平 扩展 时 ， 系统 的 能 力 是 随 着 处 理 恤 和 机 器 的 增加 而 增长 的 。 因 为 要 协调 更 多 
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的 动态 组 件 ， 所 以 会 增加 复杂 性 。 所 有 增长 的 系统 最 终 都 会 达到 一 个 点 ， 之 后 只 能 做 水 平 扩展 。 

分 布 式 数据 库 从 一 开始 就 是 按照 水 平 扩展 设计 的 。 把 数据 存储 在 多 台 机 器 上 解决 了 单 点 故障 
问题 ， 可 以 提升 耐用 性 。 很 多 关系 型 系统 都 可 以 用 分 片 、 主 /从 、 主 / 主 复制 等 形态 进行 一 定 的 水 
平 扩展 ， 但 不 会 超过 几 百 个 节点 。 比 如 MySQL 集群 的 上 限 是 255 个 节点 。 而 分 布 式 数据 库 可 以 
有 几 王 个 节点 。 





























8.8 MongoDB 


MongoDB 是 面向 对 象 的 分 布 式 数 据 库 ， 使 用 它 的 Node 开发 人 员 特 别 多 。 时 後 的 MEAN 栈 
中 的 M 就 是 MongoDB (另外 三 个 是 Express、Angular 和 Node ), 一 般 我 们 刚 开始 接触 Node 时 
遇 到 的 第 一 个 数据 库 就 是 它 。 从 图 8-2 可 以 看 出 mongodb 模块 有 多 火 。 

















npm install mongodb 
3 dependencies version 2.2.0 
1,893 dependents updated 6 hours ago 


1,807,134 downloads in the last month 
download rank: top 1% of 296,000 packages 


图 8-2 MongoDB 的 使 用 统计 


MongoDB 受到 的 批评 和 争议 非常 多 。 尽 管 如 此 ， 它 仍然 是 很 多 开发 人 员 的 主 存储 。 很 多 车 
名 公司 都 部 署 了 MongoDB， 包括 Adobe、Linkedm 、eBay， 甚 至 欧洲 粒子 物理 研究 所 ( CERN ) 
的 大 型 强 子 对 撞 机 组 件 上 都 在 用 它 。 

MongoDB 数据 库 把 文档 存储 在 无 模式 的 数据 集中 。 不 需要 预先 为 文档 定义 模式 ， 同 一 个 数 
据 集中 的 文档 也 不 用 遵循 相同 的 模式 。 这 给 了 MongoDB 很 大 的 灵活 性 ,但 程序 要 因此 承担 起 保 
证 数据 一 致 性 的 责任 ， 确 保 文 档 的 结构 是 可 预测 的 。 




















8.8.1 安装 和 配置 
不 同系 统 上 的 MongoDB 安装 是 不 一 样 的 。MacOS 上 就 是 简单 的 : 


brew install mongodb 
MongoDB 服务 器 是 用 可 执行 文件 mongod 启动 的 : 
mongod --config /usr/local/etc/mongod.conf 


Christian Amor Kvalheim 的 官方 mongodb 包 是 最 受 欢 迎 的 MongoDB 驱动 : 


npm install mongodb@’^2.1.0 --save 


Windows 用 户 注意 一 下 ， 这 个 驱动 的 安装 需要 Microsoft Visual Studio 的 msbuild.exe。 





8.8.2 连接 MongoDB 


装 好 mongodb 包 ， 局 动 了 mongod 服务 器 之 后 ， 可 以 从 Node 中 作为 客户 端 连接 它 ， 代 码 如 
下 所 示 。 
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代码 清单 8-8 ”连接 MongoDB 
const { MongoClient } = require('mongodb'); 
MongoClient.connect ('mongodb://localhost:27017/articles') 
.then(db => { 
console.log('Client ready'); 


db.close(); 
}, console.error); 


连接 成 功 的 处 理 器 会 得 到 一 个 数据 库 客 户 端 实例 ， 所 有 数据 库 命令 都 是 交 给 它 执行 的 。 
大 部 分 数据 库 交 互 都 是 通过 collection API 完成 的 : 
口 collection.insert (doc) 一 一 插入 一 个 或 多 个 文档 ; 
on.find (query) 一 一 找到 跟 查 询 匹 配 的 文档 ; 
口 collection.remove (gquery) 移 除 跟 查 询 匹配 的 文档 ; 
口 collection.drop() 一 一 移 除 整个 数据 集 ; 
O 〇 
O 〇 








口 collecti 








n.update (duery ) 更 新 跟 查 询 匹配 的 文档 ; 

口 collection.count (duery) 一 一 对 跟 查 询 匹 配 的 文档 计数 。 

为 满足 操作 一 个 或 多 个 文档 的 需求 ，find、insert 和 aelete 等 操作 有 几 种 变 体 。 比 如 ; 
n.insertone (doc) 插 和 人 单个 文档 ; 


口 collecti 
































DQ collectio 

口 collection.insertMany ([doc1,doc2]) 一 一 插入 多 个 文档 ; 

DQ collection.findqone (gquery) 找到 一 个 跟 查 询 匹 配 的 文档 ; 
口 collection.updateMany (gquery) ) 一 一 更 新 所 有 跟 查 询 匹 配 的 文档 。 


8.8.3 插入 文档 


collection.insertone 将 单个 对 象 作为 文档 存 到 数据 集 里 ， 代 码 如 下 所 示 。 成 功 处 理 右 
会 得 到 一 个 包含 操作 元 信息 的 对 象 。 


代码 清单 8-9 ”插入 文档 

Onet rtie Le et{ 
title: 'I like cake', 
content: 'It is quite googd.' 

}; 

db.collection('articles') 
.insertOne (article) 

.then(result => { 








console.log(result.insertedId); 所 | 如 果 文档 没有 _ id， 会 创建 一 个 新 
console.log(article._id); B < 的 ID，inserteaia 就 是 那个 ID 
)) ; a : 
定义 文档 的 原始 对 象 中 增 


加 了 一 个 新 属性 _ia 
insertMany 的 用 法 也 差不多 ， 只 是 参数 是 包含 多 个 对 象 的 数组 。insertMany 的 结果 不 再 
是 一 个 insertedIda， 而 是 包含 多 个 ID 的 insertedqias 数组 ，ID 的 顺序 跟 作 为 参数 的 数组 中 
的 文档 顺序 一 样 。 
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8.8.4 查询 


从 数据 集中 读 取 文档 的 方法 (比如 finda、update 和 remove ) 都 会 有 一 个 查询 参数 ， 用 来 
匹配 文档 。 最 简单 的 查询 是 一 个 对 象 ，MongoDB 会 匹配 结构 和 值 相同 的 文档 。 比 如 下 面 这 个 查 
询 会 匹配 所 有 标题 为 “Ilike cake” 的 文档 : 








db.collection('articles') 
.find({ title: 'I like cake' }) 
.toArray () .then(results => { 包含 所 有 跟 查 询 匹 
console.log(results); < 配 的 文档 的 数组 


上 
查询 可 以 用 具有 唯一 性 的 _ia 进行 匹配 : 
collection.findone({ _id: someID }) 


或 者 基于 查询 操作 符 匹配 : 






































db.collection('articles') 标题 以 “cake” 结 尾 的 
.find({title: { $regex: /cake$/I }) < 一 文档 ， 大 小 写 敏感 

MongoDB 查询 语言 中 的 查询 操作 符 很 多 ， 比 如 : 

口 $eq 一 一 等 于 某 个 值 ; 

口 $neq 一 一 不 等 于 某 个 值 ; 

口 $in 一 一 在 数组 中 ; 

口 Snin 不 在 数组 中 ; 

口 slt、$lte、$gt、$gte 一 一 大 于 /小 于 或 等 于 比较 值 ; 

D snear 地 理 位 置 值 在 某 个 区 域 附近 ; 

D snot、 $and、 sor、S$nor 逻辑 操作 符 。 











这 些 操作 符 几 乎 可 以 组 合 出 所 有 查询 条 件 , 创造 出 可 读 性 强 、 精 巧 的 、 富 有 表达 力 的 查询 语 
句 。 更 多 与 查询 和 查询 操作 符 有 关 的 内 容 请 浏览 Query and Projection Operators 网 站 。 

下 面 这 段 代码 用 MongoDB 实现 了 之 前 那个 Articles API， 对 外 部 使 用 者 来 说 几乎 是 一 样 的 。 
将 这 个 保存 为 db.js( 示例 源码 见 listing8_10/dbjs )。 





代码 清单 8-10 用 MongoDB 实现 Article API 


const { MongoClient, ObjectID } = require('mongodb'); 
let db; 


module.exports = () => { 
return MongoClient 
.Connect ('mongodb://localhost:27017/articles') 
:thent(elient) => 
db = client; 
})yz 
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modqule .exports .Article = { 
a (mE 
return db.collection('articles2').find().sort({ title: 1 }) .toArray (); 
} 
find(_id) { 
if (typeof _id !== 'object') _id = ObjectID(_id) ; < 一 支持 字 
- : i 地 字 符 串 或 
return db.collection('articles2').findone({ _ id }) ObjectID 类 型 
的 _ia 参数 


create(data) { 
return db.collection('articles2').insertOne(data, { w: 1 }); 


delete(_id) { 
if (typeof _id !== 'object') _id = ObjectID(_id); 
return db.collection('articles2').deleteOne({ _iqd }, { w: 1 }); 


下 面 这 段 代 码 是 代码 清单 8-10 的 用 法 示范 ( 示例 源码 见 listing8_10/index.js ): 


const db = require('./db'); 





db().then(() => { 
db.Article.create({ title: 'An article!' }).then(() => { 
db.Article.all() .then(articles => { 
console.log(articles); 
process.exit (); 
} 
}); 
})3 


这 段 代码 用 了 代码 清单 8-10 中 连接 数据 库 返 回 的 promise， 然 后 用 Article 的 create 方 
法 创建 了 一 篇 文章 。 再 加 载 所 有 文章 ， 输 出 。 


























8.8.5 使 用 MongoDB 标识 


MongoDB 的 标识 是 二 进 制 JSON ( BSON ) 格式 的 。 文 档 上 的 _ia 是 一 个 JavaScript 对 象 ， 
其 内 部 封装 了 BSON 格式 的 objectID。BSON 格式 是 文档 在 MongoDB 内 部 的 表示 和 传输 格式 ， 
它 比 JSON 的 空间 利用 率 高 ， 解 析 速 度 快 ， 也 就 是 说 可 以 用 更 低 的 带宽 达成 更 快 的 数据 库 交 互 。 

BSON 格式 的 objectID 并 不 是 随机 的 字 节 序列 ， 它 编码 了 卫 何 时 在 何 处 生成 的 元 数据 。 
比如 objectID 的 前 四 个 字 节 ， 它 们 是 时 间 戳 。 因 此 文档 中 没 必 要 再 单独 存 一 个 createdAt 时 
间 戳 ; 


const id = new ObjectID(61bd7f57bf1532835dqd6174b) ; getTimestamp 返回 JavaScript 日 期 : 
3 2016-07-08T14:49:05.000Z 



















































































id.getTimestamp(); 
https://docs.mongodb.com/manual/reference/method/ObjectId/ 中 有 关于 ObjectID 格式 的 更 多 


信息 。 
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在 终端 里 输出 时 ，objectID 表面 上 看 起 来 可 能 像 字符 串 一 样 ,但 实际 上 是 对 象 。 所 以 在 进 
行 比较 时 , 解释 器 会 报告 说 两 个 看 起 来 完全 一 样 的 值 是 不 同 的 , 因为 它们 是 指向 不 同 对 象 的 引用 
值 。 这 就 是 经 典 的 对 象 比 较 陷 阱 。 

下 面 的 代码 两 次 提取 相同 的 对 象 。 我 们 试图 用 Node 自 带 的 assert 模块 断言 这 两 个 ID 或 者 说 
对 象 是 相等 的 ， 结 果 却 失败 了 : 


const Articles = db.collection('articles'); 
Articles.find() .then(articles => { 
COnst artrelrel =-articoles[0y; 
return Articles 
"findone({t lid artreLlel:. tdy) 
.then(article2 => { 
assert.equal (article2._id, articlel. id); 
}) 
小) 必 


这 些 断 言 产生 的 错误 信息 看 起 来 会 让 人 觉得 很 困惑 ， 因 为 实际 值 和 期 望 值 似乎 真 的 一 模 
一 样 : 

operator: equal 

expected: 577f6b45549a3b991elc3c18 


actual: 577f6b45549a3b991elc3c18 
operator: equal 
expected: 
{ _id: 577f6b45549a3b991elc3c18, title: 'attractive-money' ... } 
actual: 
{ _id: 577f6b45549a3b991elc3c18, title: 'attractive-money' ... } 

















ObjectID 有 个 equal 方法 ， 所 有 的 _ia 都 可 以 用 这 个 方法 判断 它们 是 否 相 等 。 另 外 ， 你 也 
可 以 将 标识 强制 转换 为 字符 串 进 行 比较 ， 或 者 用 assert 模块 的 deepEquals 方法 : 
articlel._id.equals (article2._ idq) ; 


String(articlel._id) === String(article2._ iqd); 注意 ， 如 果断 言 结果 为 false， 
并 ee 
assert.deepEqual (articlel._id, article2._ id); < 这 里 会 扫 出 异常 


传 给 mongodb 驱动 的 标识 必须 是 BSON 格式 的 objectID。objectID 构造 器 可 以 将 字符 串 
转换 成 ObjectID: 


const { ObjectID } = require('mongodb'); 
const stringID = '577f6b45549a3b991elc3c18'; 
const bsonID = new ObjectID(stringID); 


要 尽 可 能 保持 BSON 格式 。 在 BSON 和 字符 串 之 间 的 相互 转换 会 以 牺牲 性 能 为 代价 ， 这 违 
背 了 MongoDB 把 BSON 格式 的 标识 交 给 客户 端的 初衷 。 请 参阅 BSON 官网 了 解 BSON 格式 的 
详细 信息 。 


8.8.6 ”使 用 复制 集 
MongoDB 的 分 布 式 功能 超出 了 本 书 的 讨论 范围 ， 但 我 们 还 是 要 用 一 节 的 篇 幅 快速 介绍 一 下 
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复制 集 的 基础 知识 。 多 个 mongod 进程 可 以 作为 复制 集 的 节点 /成 员 运 行 。 复 制 集 是 由 一 个 主 节 
点 和 无 数 个 从 节点 组 成 的 。 复制 集中 的 每 个 成 员 都 会 分 到 唯一 的 端口 和 目录 存储 自己 的 数据 。 各 
个 实例 不 能 共享 端口 和 目录 ， 并 且 在 启动 之 前 这 些 目录 必须 是 已 经 存在 了 。 

下 面 的 代码 为 每 个 成 员 创建 了 唯一 的 目录 , 并 从 端口 27017 开始 按 顺序 启动 它们 。 如 果 不 想 
让 mongogd 在 后 台 运 行 (命令 中 不 带 & )， 可 以 为 每 个 mongod 命令 开 一 个 新 的 终端 标签 。 


代码 清单 8-11 ”启动 一 个 复制 集 


mkdir -p ./mongodata/db0 ./mongodata/dbl ./mongodata/db2 









































确保 没有 其 他 mongod 
pkill mongod 实例 运行 

sleep 3 
让 已 有 实 
例 有 时 间 
关 停 


mongod --port 27017 --dbpath ./rs0-data/db0 --replSet rs0 & 
mongod --port 27018 --dbpath ./rs0-data/dbl --replSet rs0 & 
mongod --port 27019 --dbpath ./rs0-data/db2 --replSet rs0 & 


复制 集 跑 起 来 之 后 ，MongoDB 需要 执行 一 些 初 始 化 操作 。 你 需要 连接 到 希望 让 它 做 主 节 点 
的 那个 实例 ( 默认 是 27017 ), 并 像 下 面 这 样 调用 rs .initiate()。 然 后 把 这 些 实例 作为 成 员 添 
加 到 复制 集中 。 注 意 要 提供 所 连 机 融 的 主机 名 。 
代码 清单 8-12 ”复制 集 的 初始 化 


mongo --eval "rs.initiate()" 























mongo --eval "rs.add(' hostname :27017')" < 一 J] UNIX 命令 hostname 会 
mongo --eval "rs.add(' hostname :27018')" 输出 当前 机 器 的 主机 名 


mongo --eval "rs.add('‘hostname :27019')" 


在 建立 连接 时 , MongoDB 客户 端 需要 知道 所 有 的 复制 集成 员 , 但 并 不 要 求 所 有 成 员 都 在 线 。 
连 上 之 后 就 可 以 照常 使 用 了 。 代 码 清单 8-13 创建 了 一 个 由 三 个 成 员 组 成 的 复制 集 。 


代码 清单 8-13 ”创建 复制 集 
const os = require('os'); 
const { MongoClient } = require('mongodb'); 
const hostname = os.hostname(); 

















const members = |[ 
‘$s{hostname}:27018.，, 
‘$s{hostname}:27017.,，, 





‘${hostname}:27019、 test 是 数据 库 名 ， 
Bs rs0 是 复制 集 的 名 称 
MongoClient.connect (‘mongodb://s{members.join(',')}/test?replSet=rs0.) < 二 一 一 
.then(db => { 
db.admin() .replSetGetStatus().then(status => { < replSetGetStatus 
console.log(status); 会 输出 复制 集 的 成 员 


db.close(); 言 息 和 元 数据 
}); 
} 
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即便 有 节点 崩溃 ,但 只 要 仍 在 运行 的 mongod 节点 不 少 于 两 个 ， 系 统 就 能 继续 工作 。 如 果 主 
节点 骨 溃 了 ， 系 统 会 自动 推举 一 个 从 节点 升 为 主 节点 。 





8.8.7 ”了解 写 关注 


在 使 用 MongoDB 时 ， 开 发 人 员 能 够 对 性 能 和 安全 上 的 折 中 选项 做 精细 的 控制 ， 以 满足 程序 
不 同 区 域 的 需要 。 要 想 不 出 意外 ， 必 须 掌 握 MongoDB 的 写 关 注 和 读 关注 这 两 个 概念 ， 特 别 是 在 
复制 集中 的 节点 不 断 增多 时 。 由 于 篇 幅 有 限 ， 本 节 只 讨论 最 重要 的 写 关 注 。 

写 关 注 本 质 上 是 个 数量 值 ， 表 明 MongoDB 在 返回 操作 整体 成 功 的 响应 之 前 ， 需 要 把 数据 成 
功 写 人 多 少 个 mongod 实例 。 如 果 不 特别 指明 ， 写 关注 的 默认 值 是 1， 即 确保 数据 成 功 写 人 至 少 
一 个 节点 。 对 于 重要 数据 而 言 ， 这 样 的 保证 水 平 是 不 够 的 。 如 果 在 数据 复制 到 其 他 节点 之 前 ,这 
个 节点 下 线 了 ， 那 数据 可 能 就 丢 了 。 

从 程序 角度 来 讲 , 有 可 能 , 实际 上 是 经 常 希望 把 写 关 注 设 为 0, 即 程序 根本 不 想 为 MongoDB 
的 响应 而 等 待 : 
qb.collection('qata').insertone(dqata，{ w: 0 }); 

写 关 注 为 0 时 性 能 水 平 达到 最 高 , 但 同时 耐用 性 保证 降 到 最 低 , 一 般 只 在 临时 或 不 重要 的 数 
据 上 使 用 〈 比如 写 日 志 或 缓存 )。 

在 连 到 复制 集 上 时 ， 写 关注 可 以 大 于 1。 把 数据 复制 到 更 多 节点 上 可 以 降低 其 丢失 的 风险 ， 

但 代价 是 操作 延 时 会 更 长 : 


db.collection('data').insertOone(data, { w: 2 }); 
db.collection('data').insertOne(data, { w: 5 }); 


写 关 注 也 可 以 随 着 集群 中 节点 数量 的 变化 而 变化 。 当 写 关 注 被 设 为 majority 时 ，MongoDB 
能 自行 动态 调整 它 的 值 。 此 时 数据 一 定 会 写 人 至 少 50% 的 可 用 节点 : 
dqb.collectionl('dqata').insertone(dqata，({( w: 'majority' }); 
默认 值 的 写 关 注 1 可 能 无 法 充分 保证 重要 数据 的 安全 。 如 果 在 数据 复制 到 其 他 节点 之 前 , 这 
个 三 点 下 线 了 ， 那 数据 可 能 就 于 了 。 

写 关 注 大 于 1 时， 可 以 确保 在 继续 操作 之 前 数据 会 写 信 到 多 个 mongod 实例 上 。 在 同一 台 机 
器 上 运行 多 个 实例 确实 可 以 提高 数据 的 安全 性 ， 但 出 现 系统 性 故障 时 ， 比 如 硬盘 空间 或 RAM 耗 
光 了 , 这 样 的 配置 是 无 济 于 事 的 。 如 果 把 节点 分 布 在 多 台 机 器 上 , 并 确保 写 人 操作 会 传播 到 这 些 
节点 上 时 ， 可 以 保证 数据 不 受 机 器 故障 的 影响 , 但 同样 ， 整 个 数据 中 心 都 出 问题 时 就 不 行 了 ,并 
且 写 操作 会 变 得 更 慢 。 把 节点 分 布 到 多 个 数据 中 心 可 以 保证 数据 不 受 数 据 中 心 级 故障 的 影响 , 但 
将 数据 复制 到 多 个 数据 中 心 对 性 能 的 影响 非常 大 。 

保障 越 多 ， 系 统 越 慢 ， 也 越 复杂 。 不 仅 MongoDB 如 此 ， 所 有 数据 存储 都 这 样 。 没 有 完美 的 
解决 方案 ， 你 需要 决定 将 程序 各 部 分 的 风险 水 平 控制 在 什么 范围 内 。 

可 以 参考 以 下 资料 进一步 了 解 MongoDB 复制 的 工作 机 制 : 
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口 https://docs.mongodb.com/manual/fagq/replica-sets/ 





口 https:/docs.mongodb.com/manual/faq/concurrency/ 


8.9” 键 / 值 存储 


键 / 值 存储 中 的 所 有 记录 都 是 由 一 个 键 值 对 构成 的 。 大 多 数 键 / 值 系统 都 不 对 值 的 数据 类 型 、 
长 度 和 结构 做 限制 。 在 键 / 值 数据 库 看 来 ， 值 是 不 透明 的 原子 : 数据 库 不 知道 ， 或 者 说 不 关心 值 
的 数据 类 型 ， 并且 将 值 作为 一 个 整体 ， 不 会 切 分 或 访问 其 中 的 部 分 数据 。 在 关系 型 数据 库 中 ， 数 
据 一 行 行 地 存在 表 中 ， 每 一 行 都 分 成 预先 定义 好 的 列 。 但 键 / 值 存储 跟 它 相反 ， 其 把 管理 数据 格 
式 的 任务 交 给 了 应 用 程序 。 
键 / 值 存储 经 常 出 现在 程序 性 能 的 关键 路 径 上 。 理 想 情况 下 ， 值 应 该 是 按照 用 最 少 的 读 取 次 
数 完成 任务 的 标准 来 摆 放 的 。 相 较 其 他 数据 库 而 言 ， 键 / 值 存储 的 查询 能 力 比较 简单 。 复 杂 查 询 
最 好 是 预先 计算 好 的 。 和 否则 应 该 放 在 程序 里 ， 而 不 是 交 给 数据 库 执 行 。 有 了 这 样 的 限制 ， 数 据 库 
的 性 能 特征 就 更 容易 理解 和 预测 了 。 
像 Redis 和 Memcached 这 些 最 火 的 键 / 值 存储 经 常用 来 做 易 失 性 存储 ( 进程 退出 后 数据 就 没 
了 )。 避免 写 盘 操作 是 提升 性 能 的 最 佳 方式 。 如 果 数 据 可 以 重新 生成 ,或 者 琉 了 也 没 多 大 关系 时 ， 
这 种 折 中 是 可 以 接受 的 ， 比 如 作为 缓存 和 存储 用 户 会 话 数据 时 。 
可 能 很 多 人 觉得 不 能 用 键 / 值 存储 做 主 存储 ， 但 实际 上 并 非 如 此 。 很 多 键 / 值 存储 的 耐用 性 跟 
“真正 的 ”数据 库 不 相 上 下 。 
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8.10 Redis 


Redis 是 热门 的 结构 化 内 存 数据 库 。 尽 管 很 多 人 认为 Redis 是 键 / 值 存储 ， 但 实际 上 键 和 值 只 
是 Redis 所 支持 的 众多 数据 结构 中 的 一 种 ， 它 还 支持 很 多 实用 的 基础 结构 。 图 8.3 是 redis 包 在 npm :| 
上 的 使 用 统计 。 





























图 8-3 redis 包 在 npm 上 的 使 用 统计 


Redis 原生 支持 的 数据 结构 包括 : 
口 字符 串 

口 散 列 表 

口 列表 
口 集合 
口 有 序 集 
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Redis 还 有 很 多 实用 的 功能 : 
口 位 图 数据 一 一 直接 在 值 上 进行 位 操作 ; 
口 地 理 位 置 索引 一 一 存储 带 半 径 查 询 的 地 理 位 置 数据 ; 
D 频道 一 一 一 种 发 布 /订阅 数据 传递 机 制 ; 
口 TTL 一 一 数据 可 以 有 过 期 时 间 ， 过 期 之 后 自动 清除 ; 
口 LRU 逐 出 一 一 有 选择 地 移 除 最 近 不 用 的 数据 ， 以 便 维持 内 存 的 利用 率 ; 
口 HyperLogLog 一 一 用 很 低 的 内 存 占用 求 集合 基数 的 高 性 能 算法 (不 需要 存储 所 有 成 员 ); 
口 复制 、 集 群 和 分 区 一 一 水 平 扩展 和 数据 耐用 性 ; 
口 Lua 脚本 可 以 给 Redis 添加 自 定义 的 命令 。 
本 节 会 介绍 一 些 Redis 命令 ， 但 我 们 的 出 发 点 不 是 要 给 你 一 份 参考 手册 ， 而 是 希望 能 借 此 让 
你 了 解 Redis 的 能 力 。Redis 真 的 是 一 个 超 强 的 多 面 手 , http:/redis.io/commands 上 有 更 详细 的 介绍 。 


8.10.1 安装 和 配置 


可 以 用 系统 上 的 包 管 理工 具 安装 Redis。 在 macOS 上 用 Homebrew 安装 很 简单 : 


brew install redis 


用 可 执行 文件 redis-server 启动 服务 器 : 


redis-server /usr/local/etc/redis.conf 


服务 器 默认 的 监听 端口 是 6397。 




































































8.10.2 ”初始 化 


Redis 客户 端 实例 是 用 redis npm 包 的 createclient 函数 创建 的 : 


const redis = require('redis'); 
const db = redis.createClient (6379, '127.0.0.1'); 


这 个 函数 以 端口 和 服务 器 的 主机 地 址 为 参数 。 如 果 Redis 运行 在 本 机 的 默认 端口 上 ， 则 无 须 
提供 参数 : 

const db = redis.createClient (); 
就 像 代码 清单 8-14 所 展示 的 , 因为 Redis 客户 端 实例 是 一 个 EventEmitter, 所 以 我 们 可 以 
通过 它 监听 各 种 Redis 状态 事件 。 不 用 等 着 连接 准备 好 再 向 客户 端 发 送 命 令 ， 这 些 命令 会 缓存 到 
连接 就 绪 。 
代码 清单 8-14 ”连接 到 Redis 监听 状态 事件 


const redis = require('redis'); 






















































































const db = redis.createClient (); 

db.on('connect', () => console.log('Redis client connected to server.')); 
db.on('ready', () => console.log('Redis server is ready.')); 
db.on('error', err => console.error('Redis error', err)); 
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出 现 连接 或 客户 端 方面 的 问题 时 会 触发 错误 处 理 器 。 如 果 发 生 了 error 事件 ,但 没有 监听 
该 事件 的 错误 处 理 器 ， 程 序 会 抛 出 错误 然后 退出 。Node 中 的 所 有 EventEmitter 都 是 这 样 的 。 
如 果 连 接 失 败 后 有 错误 处 理 需 ，Redis 客户 端 会 尝试 重新 连接 。 


8.10.3 ”处 理 键 / 值 对 


Redis 可 以 当 作 普通 的 键 / 值 存储 用 ， 支 持 字 符 串 和 任何 二 进 制 数 据 。 分 别 用 get 和 set 方 
法 读 写 键 / 值 对 : 
db.set('color', 'red', err => { 


if (err) throw err; 


}); 




















db.get('color', (err, value) => { 
if (err) throw err; 
console.log('Got:', value); 

}03 


如 果 写 入 的 键 已 经 存在 了 ， 那 么 原来 的 值 会 被 覆盖 掉 。 如 有 果 读 取 的 键 不 存在 ， 则 会 得 到 值 
null ， 而 不 会 被 当 作 错 误 。 
下 面 这 些 命令 是 用 来 获取 和 人 处理 值 的 : 
D append 
DQ decr 
DQ decrby 
口 get 











口 getrange 
DQ getset 





DQ incr 

incrby 
incrbyfloat 
mget 

mset 
msetnx 
psetex 

set 

setex 
setnx 


setrange 





日 国 :四 ;1 国 |- 自 县 日 国有 鼎 ': 自 , : 自 


strlen 
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8.10.4 ”处理 键 








exists 可 以 检查 其 个 键 是 否 存在 ， 它 能 接受 任何 数据 类 型 ; 
db.exists('users', (err，qQqoesExist) => { 
if (err) throw err; 
console.log('users exists:', doesExist); 


oy 

除了 exists， 下 面 这 些 命令 都 可 以 用 在 键 上 ， 任 何 类 型 的 值 都 可 以 ( 这 些 命 令 可 以 接受 字 
符 串 、 集 合 、 列 表 等 类 型 ): 

D del 


口 exists 


























D rename 
D renamenx 
口 sort 


口 scan 





口 type 


8.10.5 ”编码 与 数据 类 型 


在 Redis 服务 器 里 ， 键 和 值 是 二 进 制 对 象 ， 跟 传 给 客户 端 时 所 用 的 编码 没关系 。 所 有 有 效 的 
JavaScript 字符 串 ( UCS2/UTF16 ) 都 是 有 效 的 键 或 值 : 




















dbsSet (Voreeting”; 人 rt Ledles Brintyy 
db.get ('greeting', redis.print); 

dB Set (LEO 2 Tedlie HOLL )s 
db.get ('icon', redis.print); 


ST 








默认 情况 下 ， 在 写 入 时 会 将 键 和 值 强制 转换 成 字符 串 。 比 如 说 ， 如 果 设 定 某 个 键 的 值 是 数 
字 ， 那 么 在 读 取 这 条 记录 时 ， 得 到 的 值 将 会 是 个 字符 串 : 
db.set('colors', 1, (err) => { 


if (err) throw err; 


}); 





db.get('colors', (err, value) => { | 
if (err) throw err; 值 的 类 型 
© 8 是 字符 串 

console.log('Got: %s as %s', value, typeof value); < 一 年 


) 

Redis 客户 端 会 默默 地 将 数字 、 布 尔 值 和 日 期 转换 成 字符 串 ， 它 也 乐意 接受 缓冲 区 对 象 。 除 
此 之 外 ， 设 定 其 他 任何 JavaScript 类 型 ( 比如 对 象 、 数 组 、 正 则 表达 式 ) 的 值 时 ， 客 户 端 都 会 发 
出 一 个 不 应 被 忽略 警告 : 


db.set('users', {}, redis.print); 








Deprecated: The SET command contains a argument of type Object. 
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This is converted to "[object Object]" by using .toString() now 
and will return an error from V.3.0 on. 

Please handle this in your code to make sure everything works 
as you intended it to. 














将 来 这 会 变 成 错误 ， 所 以 一 定 要 让 程序 确保 传 给 Redis 客户 端的 数据 类 型 是 正确 的 。 
1. 陷阱 : 单 值 和 多 值 数组 
如 果 值 是 包含 多 个 值 的 数组 , 那么 客户 端 会 报 一 个 很 神秘 的 错误 ， 即 “ReplyError: ERR syntax 


93 
erOT : 





db.set('users', ['Alice', 'Bob'], redis.print); 
日 如 果 数 组 中 只 有 一 个 值 ， 则 不 会 报错 : 
db.set('user', ['Alice'], redis.print); 


db.get('user', redis.print); 
这 种 bug 可 能 要 等 到 程序 上 线 后 才 会 爆发 ， 因 为 测试 集 一 般 都 用 简 版 的 测试 数据 ,可 能 生成 
的 数组 恰好 只 有 一 个 值 ， 所 以 让 bug 轻松 躲 过 了 检查 。 一 定 要 注意 ! 

2. 带 缓 冲 区 的 二 进 制 数 据 

Redis 可 以 存储 任何 二 进 制 数据 ， 也 就 是 说 它 可 以 存储 任何 类 型 的 数据 。Node 客户 端 对 这 一 
功能 的 支持 是 用 Node 的 Buffer 类 型 实现 的 。 当 Redis 客户 端 收 到 缓冲 区 类 型 的 键 或 值 时 ， 会 
原封 不 动 地 将 这 些 字 节 发 给 Redis 服务 咒 。 为 了 避免 可 能 会 出 现 的 数据 破坏 或 性 能 损失 ， 客 户 端 
不 会 进行 缓冲 区 和 字符 串 之 间 的 类 型 转换 。 比 如 说 ， 如 果 要 把 硬盘 或 网 络 上 的 数据 直接 写 到 Redis 
中 ,那么 直接 写 缓冲 区 里 的 数据 明显 会 比 先 把 数据 转 成 字符 串 再 写 更 高 效 。 



























































组 冲 区 
缓冲 区 是 Node 的 核心 文件 和 网 络 API 黑 认 提 供 的 结果 。 它 们 是 二 进 制 数据 连续 块 的 容器 ， 
在 JavaScript 还 没有 自己 的 原生 二 进 制 数据 类 型 (Uint8Array、Float32Array 等 ) 时 就 已 
经 在 Node 里 了 。 现在 它 是 Uint8Array 的 特殊 子 类 。Buffer API 在 Node 中 是 可 以 全 局 访问 的 ， 
用 它 不 需要 require 任何 东西 。 
参见 https://github.com/nodejs/mode/blob/master/lib/buffer.js 


Redis 最 近 添 了 一 些 操作 字符 串 上 单个 位 的 命令 ， 在 处 理 缓 冲 区 时 也 可 以 用 : 
口 pitcount 

DQ pitfield 

D bitop 

口 setbit 





D pitpos 
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8.10.6 ”使 用 散 列 表 


散 列 表 是 键 / 值 对 的 数据 集 。hmset 命令 的 参数 是 一 个 键 和 一 个 表示 散 列 键 / 值 对 的 对 象 。 
hmget 可 以 读 出 这 个 包含 键 / 值 对 的 对 象 ， 代 码 如 下 所 示 。 


代码 清单 8-15 ”将 数据 存在 Redis 散 列 表 中 


db.hmset ('camping', 1 、 
Ls nd 设 定 散 列表 
和 ' 键 / 值 对 
cooking: 'campstove' 
}, redis.print); 





























获取 “camping.cooking” 


db.hget ('camping', 'cooking', (err, value) => { 的 值 
if (err) throw err; 
console.log('Will be cooking with:', value); 
a 以 数组 形式 
db.hkeys('camping', (err, keys) => { -4 获取 散 列 键 
if (err) throw err; 
keys.forEach(key => console.log(. S${key} )); 


人 
Redis 散 列 表 中 不 能 存储 带 般 入 结构 的 对 象 ， 只 能 有 一 层 。 
下 面 这 些 是 操作 散 列表 的 命令 : 
hdel 





hexists 
nget 
hgetall 
hincrby 
hincrbyfloat 
hkeys 
hlen 
nmget 
nmset 
hset 
nsetnx 
hstrlen 


hvals 





DoOOOOOOOOOOoOOODO DO 





NScCan 


8.10.7 ”使 用 列表 


列表 是 包含 字符 串 值 的 有 序数 据 集 , 可 以 存在 同一 值 的 多 个 副本 ,列表 在 概念 上 跟 数 组 类 似 。 
最 好 当 作 栈 (LIFO: 后 进 先 出 ) 或 队列 ( FIFO: 先进 先 出 ) 来 用 。 
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下 面 的 代码 演示 了 如 何 将 值 存 到 列表 中 然后 读 取出 来 。lpush 命令 向 列表 中 添加 了 一 个 值 。 
lrange 命令 按 范围 读 取 , 有 起 始 和 结束 索引 。 因 为 -1 表示 列表 中 的 最 后 一 个 元 素 , 所 以 下 例 中 
的 1range 会 取出 列表 中 的 所 有 元 素 : 


client.lpush('tasks', 'Paint the bikeshed red.', redis.print); 
client.lpush('tasks', 'Paint the bikeshed green.', redis.print); 
client.lrange('tasks', 0, -1, (err, items) => { 

1if (ert) theow rr 

items.forEach(item => console.log(. S${item}.)); 
a 


列表 既 没 有 提供 确定 某 个 值 是 否 存在 其 中 的 办 法 , 也 没有 提供 确定 某 个 值 的 索引 的 办 法 。 我 
们 只 能 通过 手动 遍历 获取 这 些 信息 , 但 做 这 件 事 效 率 很 低 , 应 该 尽量 避免 。 如 果 你 确实 需要 这 样 
的 功能 ,应 该 考虑 使 用 其 他 数据 结构 ， 比 如 集合 ,甚至 可 以 跟 列表 配合 使 用 。 为 了 充分 利用 各 种 
性 能 特性 ， 把 数据 复制 到 多 个 数据 结构 中 并 没什么 稀奇 的 。 

下 面 这 些 是 操作 列表 的 命令 : 
D plpop 























DQ brpop 
D lindex 
linsert 


llen 


DOOOOODO 
© 
名 
Un 
ey 
” 








D rpush 





D rpushx 


8.10.8 使 用 集合 


合 是 无 序数 据 集 ， 其 中 不 允许 有 重复 值 。 集 合 是 一 种 高 性 能 的 数据 结构 ,检查 成 员 、 添 加 
和 移 除 记录 都 可 以 在 0(1) 时 间 内 完成 ， 所 以 其 非常 适合 对 性 能 要 求 比较 高 的 任务 : 





























db.sadd('admins', 'Alice', redis.print); 
db.sadd('admins', 'Bob', redis.print); 
db.sadd('admins', 'Alice', redis.print); 
db.smembers('admins', (err, members) => { 


if (err) throw err; 
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console.log (members); 


1 
下 面 这 些 是 操作 集合 的 命令 : 
sadd 





scard 

sdiff 
sdiffstore 
sinter 
sinterstore 
sismember 
smembers 
spop 
srandmember 
srem 
sunion 


sunionstore 





DoOODOOOOOOOOOoOOD DO 


SSCan 


8.10.9 用 频道 实现 发 布 /订阅 功能 





Redis 不 仅仅 是 传统 意义 上 的 数据 存储 系统 ， 它 还 提供 了 频道 。 频 道 是 可 以 实现 发 布 /订阅 功 
能 的 数据 传输 机 制 ， 图 8-4 是 频道 的 概念 图 。 聊 天 和 博彩 等 实时 程序 都 需要 这 样 的 功能 。 

















订阅 者 | 人 者 | ( im 者 | 





图 8-4 Redis 频道 为 一 种 常用 的 数据 传输 场景 提供 了 简单 的 解决 方案 





Redis 客户 端 既 可 以 订阅 频道 上 的 消息 ， 也 可 以 向 频道 发 布 消息 。 


发 给 频道 的 消息 会 传递 给 








所 有 订阅 该 频道 的 客户 端 。 发 布 者 不 需要 知道 谁 是 订阅 者 ,订阅 者 也 不 知道 发 布 者 是 谁 。 将 发 布 




















者 和 订阅 者 解 耦 是 种 强大 清晰 的 模式 。 














下 面 这 个 例子 用 Redis 的 发 布 /订阅 功能 实现 了 一 个 TCP/IP 聊天 服务 央 。 





代码 清单 8-16 用 Redis 的 发 布 /订阅 功能 实现 的 聊天 服务 天 


const net = require('net'); 


const redis = require('redis'); 为 每 个 连接 到 聊天 服务 器 
的 用 户 定义 的 配置 逻辑 


const server = net.createServer(socket => { < 
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const subscriber = redis.createClient (); 了 4 一 为 每 个 用 户 创 
频道 subscriber.subscribe('main'); 建 订阅 客户 端 
订阅 subscriber.on('message', (channel, message) => 
socket .write( ‘Channel S${channel}: ${message}. ); 从 频道 收 到 
) ) ; 人 
消息 后 显示 
const publisher = redis.createClient (); < 一 一 给 用 户 看 
socket.on('data', data => { 
publisher.publish('main', data); 为 每 个 用 户 创建 
用 户 输入 }); 发 布 客户 端 
消息 后 ， 
发 布 它 socket.on('end', () => { 
subscriber.unsubscribe('main'); < |] 如 果 用 户 断 开 了 连接 
subscriber.end (true); 结束 订阅 客户 端 
publisher.end(true); S 
了 
站 届 ; 
server.listen(3000); 
ob 
8.10.10 ”提升 性 能 
npm 包 hiredis 是 从 JavaScript 到 官方 Hiredis 的 C 语言 库 的 本 地 绑 定 。Hiredis 能 显著 提升 











Node Redis 程序 的 性 能 ， 特 别 是 在 大 型 数据 库 上 使 用 sunion、sinter、lrange 和 zrange 这 
些 操作 时 。 
只 要 装 好 hiredis ，redis 包 下 次 启动 时 就 会 自动 检测 到 hiredis， 然 后 自动 使 用 : 


npm install hiredis --save 


hiredis 几乎 没什么 缺点 ， 但 因为 它 是 从 C 代码 编译 来 的 ， 所 以 在 某 些 平台 上 构建 hiredis 可 
能 会 受到 一 些 限制 , 或 者 比较 复杂 。 跟 所 有 本 地 添加 包 一 样 ， 升 级 Node 后 可 能 需要 用 npm :| 
rebuild 重新 构建 hiredis。 


8.11 藤 入 式 数据 库 
使 用 谍 入 式 数据 库 时 不 需要 安装 或 管理 一 个 外 部 服务 器 。 它 是 嵌入 在 程序 进程 里 运行 的 。 程 
般 通 过 直接 的 过 程 调 用 跟 垦 入 式 数据 库 通信 ， 不 需要 通过 进程 间 通 信 (IPC ) 通道 或 网 络 。 
因为 很 多 时 候 程序 要 做 成 自 包 含 的 ， 所 以 只 能 选 租 入 式 数 据 库 ( 比如 移动 端 或 桌面 程序 )。 
能 入 式 数据 库 也 可 以 用 在 Web 服务 器 上 ， 经 党 用 来 实现 高 吞吐 性 的 功能 ， 比 如 用 户 会 话 或 缓存 ， 
有 时 甚至 会 作为 主 存储 。 

Node 和 Electron 程序 中 常用 的 能 人 式 数据 库 有 : 

D SQLite 

口 LevelDB 

口 RocksDB 
















































































序 一 
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口 Aerospike 

口 EJDB 

口 NeDB 

口 LokiJS 

口 Lowdb 

NeDB、LokiJS 和 Lowdb 都 是 用 纯 JavaScript 写 的 ,天 生 就 适合 能 人 到 Node 和 Electron 程序 
中 。 尽 管 有 SQLite 这 样 著名 的 可 能 和 人 关系 型 数据 库 ， 但 大 多 数 能 人 式 数据 库 都 是 简单 的 键 / 值 或 
文档 存储 。 









































8.12 LevelDB 


LevelDB 是 Google 在 2011 年 初 开 发 的 嵌入 式 持 久 化 键 / 值 存 储 ， 最 开始 是 要 给 Chrome 里 实 
现 的 IndexedDB 做 后 台 存 储 的 。LevelDB 的 设计 理念 源 于 Google 的 Bigtable 数据 库 。 它 的 竞争 对 
手 是 Berkley DB 、Tokyo/Kyoto Cabinet 和 Aerospike 这 些 数据 库 ， 但 就 本 书 所 讨论 的 内 容 而 言 ， 
可 以 把 它 当 作 最 小 功能 集 的 能 入 式 Redis。 跟 大 多 数 租 入 式 数 据 库 一 样 ，LevelDB 也 不 是 多 线程 
的 ， 不 支持 使 用 同一 个 底层 文件 存储 的 多 实例 ， 所 以 无 法 脱离 程序 的 封装 分 布 式 使 用 。 

LevelDB 中 的 键 是 按 字典 顺序 排 好 序 的 ， 值 是 用 Google 的 Snappy 压缩 算法 压缩 过 的 。 跟 
Redis 之 类 的 内 存 数据 库 不 同 ，LevelDB 总 是 把 数据 写 到 硬盘 上 ， 所 以 总 的 数据 容量 不 受 机 器 内 
存 的 限制 。 

LevelDB 只 提供 了 几 个 一 看 就 明白 的 操作 命令 : Get 、Put 、Del 和 Batch。LevelDB 还 能 
用 快照 捕获 当前 的 数据 库 状 态 , 创建 能 在 数据 集 上 前 后 移动 的 双 疝 循环 器 。 创建 循环 器 也 会 隐 含 
着 创建 快照 ， 后 续 写 操作 无 法 改变 循环 器 见 到 的 数据 。 

LevelDB 还 形成 了 一 些 支脉 ,演化 出 了 其 他 一 些 数据 库 。 由 于 有 数量 众多 的 支脉 ，LevelDB 
自身 反而 可 以 变 得 越 来 越 简 单 : 

口 Facebook 的 RocksDB ; 

口 Hyperdex 的 HyperLevelDB; 

口 Basho 的 Riak; 

口 Mojang ( Minecraft 的 创作 者 ) 的 leveldb-mcpe; 
口 用 于 比特 币 项 目的 bitcoin/leveldb。 

关于 LevelDB 的 更 多 信息 参见 其 官网 。 








































































































8.12.1 LevelUP 与 LevelDOWN 

















Node 中 对 LevelDB 提供 支持 的 是 LevelUP 和 LevelDOWN 包 , 二 者 是 由 Node 基金 会 主席 和 
多 产 的 澳大利亚 开发 者 Rod Vag 所 写 的 。LevelDOWN 用 C++ 简单 直 白 地 将 LevelDB 绑 定 到 Node 
上 ， 我 们 不 太 可 能 直接 跟 它 交互 。LevelUP 对 LevelDOWN 的 API 做 了 封装 ， 为 我 们 提供 了 更 方 
便 、 也 更 习惯 的 Node 接口 。LevelUP 还 增加 了 一 些 功 能 ,包括 键 / 值 编码 、JSON 、 等 待 数据 库 打 
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开 的 写 缓存 ， 以 及 将 LevelDB 循环 回 接口 封装 在 了 Node 流 中 。 图 8-5 是 LevelUP 在 npm 上 的 使 
用 统计 。 


npm install levelup 
7 dependencies version 1.3.2 
284 dependents updated 2 months ago 


48 痛 150,905 downloads in the last month 
download rank: top 1% of 296,000 packages 











图 8-5 LevelUP 在 npm 上 的 使 用 统计 


8.12.2 ”安装 

















在 Node 程序 中 使 用 LevelDB 最 方便 的 地 方 就 是 它 是 能 入 式 的 : 所 有 需要 的 东西 都 可 以 用 
npm 安装 。 不 需要 安装 任何 额外 的 软件 ， 执 行 完 下 面 这 个 命令 就 可 以 用 了 : 

npm install level --save 

level 包 里 封装 了 LevelUP 和 LevelDOWN ， 提 供 了 预先 配置 好 用 LevelIDOWN 做 后 台 的 
LevelUP API。level 提供 的 LevelUP API 在 LevelUP 的 介绍 文件 里 : 


D www.npmjs.com/package/levelup 














DQ www.npmjs.com/package/leveldown 


8.12.3 API 概览 
LevelDB 客户 端 存储 和 获取 数据 的 主要 方法 如 下 : 

















口 db.put (key, value, callback) 存储 键 值 对 ; 

口 ab.get (key，callback) 一 一 获取 指定 键 的 值 ; 

Dap.del (key, callback) 移 除 指定 键 的 值 ; 

口 gb.batch() .write() 一 一 执行 批 处 理 ; 

口 db.createKeyStream(options) 创建 数据 库 中 键 的 流 ; 

口 gb .createValueStream(options ) 创建 数据 库 中 值 的 流 。 














8.12.4 初始 化 


初始 化 level 时 需要 提供 一 个 存储 数据 的 路 径 ， 如 果 指 定 的 目录 不 存在 ,会 自动 创建 。 人 们 
一 般 会 用 .db 做 这 个 目录 的 后 级 ( 比如 ./app.db )。 代 码 如 下 所 示 。 


代码 清单 8-17 初始 化 level 数据 库 
const level = require('level'); 
const db = level('./app.db', { 


valueEncoding: 'json' 
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调用 过 level () 后, 返回 的 LevelUP 实例 可 以 马上 接收 命令 , 以 同步 方式 执行 。 在 LevelDB 
存储 打开 之 前 发 出 的 命令 会 缓存 起 来 ， 一 直 等 到 存储 打开 。 


8.12.5” 键 / 值 编码 


因为 LevelDB 中 的 键 和 值 可 以 是 任何 类 型 的 数据 ， 所 以 程序 要 负责 处 理 数据 的 序列 化 和 反 
序列 化 。 可 以 将 LevelUP 配置 为 直接 支持 下 面 这 些 数据 类 型 ; 
口 utf8 






































口 json 

口 binary 

口 id 

口 nex 

口 ascii 

口 base64 

口 ucs2 

DQ utfl6le 

键 和 值 默认 都 是 UTF-8 的 字符 串 。 在 代码 清单 8-17 中 ， 键 仍然 是 UTF-8 字符 串 ， 但 值 是 用 
JSON 编码 /解码 的 。 经 过 JSON 编码 后 ， 在 某 种 程度 上 来 讲 ， 对 象 或 数组 这 样 的 结构 化 数据 的 存 
储 和 获取 都 可 以 像 用 MongoDB 那样 的 文档 存储 一 样 了 。 但 并 不 像 真 正 的 文档 存储 ，LevelDB 没 
办 法 读 取 值 里 面 的 键 ， 值 是 不 透明 的 。 用 户 也 可 以 用 自己 定制 的 编码 ， 比 如 支持 像 MessagePack 
这 样 的 结构 化 数据 形态 。 


8.12.6” 键 / 值 对 的 读 写 


核心 API 很 简单 : 用 put (key，value) 写 ,用 get (key) 读 ， 用 ael (key) 删除。 请 看 代码 清 
单 8-18， 这 段 代码 应 当 添 加 到 代码 清单 8-17 中 代码 的 后 面 。 完 整 的 示例 在 随 书 源码 ch08-databases/ 
listing8_18/index.js 中 。 


代码 清单 8-18 ” 读 写 值 
const key = 'user'; 
const Value = { 

name: 'Alice' 


} 







































































db.put (key, value, err => { 
if (err) throw err; 
db.get (key, (err, result) => { 
if (err) throw err; 
console.log('got value:', result); 
db.del (key, (err) => { 
if (err) throw err; 
console.log('value was deleted'); 
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ry 
}); 


如 果 把 值 放 到 已 经 存在 的 键 上 ， 旧 值 会 被 覆盖 掉 。 当 试图 读 取 的 键 不 存在 时 会 发 生 错误 。 错 
误 对 象 的 类 型 是 NotFoungdError， 还 有 个 特殊 的 属性 err .notFounda， 可 以 把 它 跟 其 他 错误 区 
分 开 。 大 部 分 数据 库 一 般 不 会 将 其 作为 错误 , 但 因为 LevelDB 没有 提供 检查 某 个 键 是 否 存在 的 方 
法 ， 所 以 LevelUP 需要 区 分 不 存在 的 值 和 未 定义 的 值 。 与 get 不 同 ，del 不 存在 的 键 不 会 报错 。 


代码 清单 8-19 ” 读 取 不 存在 的 键 
db.get ('this-key-does-not-exist', (err, value) => { 
if (err && !err.notFound) throw err; 
if (err && err.notFound) return console.log('Value was not found.'); 
console.log('Value was found:', value); 
上 


所 有 的 数据 读 写 操作 都 可 以 通过 一 个 可 选 的 参数 改变 当前 操作 的 编码 ， 代 码 如 下 所 示 。 
代码 清单 8-20 ” 履 盖 具 体操 作 的 编码 


Const “OptrOoOns’ ,+ 
keyEncoding: 'binary', 
valueEncoding: 'hex' 


}; 






























































db.put (new Uint8Array ([1, 2, 3]), 'OxFF0099', options, (err) => { 
if (err) throw err; 
db.get (new Uint8Array ([1, 2, 3]), options, (err, value) => { 


if (err) throw err; 
console.log(value); 
} 
I 





8.12.7 “可 插 拔 的 后 台 


把 LevelUP/LevelDOWN 分 开 还 有 个 好 处 ，LevelUP 可 以 用 其 他 数据 库 做 存储 后 台 。 所 有 能 
用 MemDown API 封 装 的 东西 都 可 以 变 成 LevelUP 的 存储 后 台 , 从 而 允许 你 用 完全 相同 的 API 跟 
这 些 数据 存储 交互 。 
下 面 这 些 数 据 库 都 可 以 做 LevelUP 的 存储 后 台 : 
口 MySQL 
口 Redis 
口 MongoDB 
口 JSON 文 件 
口 Google 电子 表格 
DD AWS DynamoDB 
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口 Windows Azure 表 存 储 
口 浏览 吉 Web 存储 ( IndexedDB/localStorage ) 
拥有 了 这 种 可 以 轻松 切换 存储 介质 ,甚至 编写 自己 的 存储 后 台 的 能 力 , 我 们 就 可 以 用 一 套数 





























据 库 API 应 对 各 种 情况 和 环境 。 用 一 套数 据 库 API 掌 管 一 切 ! 














memdown 是 比较 常用 的 后 台 ， 它 把 值 都 存在 内 存 里 ， 就 像 使 用 内 存 模式 的 SQLite 一 样 ， 


非常 适合 放 在 测试 环境 里 来 降低 测试 配置 和 重 置 的 成 本 。 











运行 下 面 的 代码 需要 安装 LevelUP 和 memdown: 


npm install --save levelup memdown 


代码 清单 8-21 通过 LevelUP 使 用 memdown 


const level = require('levelup') 
const memdown = require('memdown') 
对 于 memdown 来 说 ， 这 里 的 “路 径 ” 可 以 
const db = level('./level-articles.db', { < 是 任意 字符 串 ， 因 为 它 根本 不 用 硬盘 
keyEncoding: 'json', 
valueEncoding: 'json', | 唯一 的 区 别 是 将 参数 
db: memdown 二 db 设 为 memdown 
二 


这 个 例子 仍然 用 了 之 前 用 的 level 包 ， 因 为 它 只 是 LevelUP 的 封装 。 但 如 果 你 不 想 用 level 中 














的 LevelDOWN ， 可 以 直接 用 LevelUP， 以 免 因 为 LevelDOWN 形成 对 LevelDB 的 依赖 。 


8.12.8 ”模块 化 数据 库 


动 。 














很 多 Node 开发 人 员 都 被 LevelDB 的 性 能 和 精简 所 打动 ， 并 由 此 发 起 了 一 场 模 块 化 数据 库 运 
其 理念 是 应 该 可 以 根据 需要 挑选 数据 库 的 功能 ， 让 它 跟 程序 完全 匹配 。 
下 面 是 一 些 可 以 通过 npm 包 实 现 的 LevelDB 模块 化 功能 : 

口 原子 更 新 

口 自 增长 的 键 

口 地 理 位 置 查询 

口 实时 更 新 流 

口 LRU 逐 出 

口 Map/reduce 任务 

口 主 / 主 复制 

口 主 / 从 复制 

口 SQL 查询 

口 二 级 索引 

口 触发 需 

口 版 本 化 数据 
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LevelUP 的 wiki 上 有 相当 完备 的 LevelDB 生态 系统 概述 ， 在 npm 上 搜 leveldb 也 能 找到 很 多 
包 ， 在 写 这 本 书 时 我 们 搜 到 了 898 个 。 图 8-6 可 以 说 明 LevelDB 在 npm 上 有 多 受 欢 迎 。 


SE 
[i leveldb Q | senuporlogin (OD 





898 results for ‘leveldb’ 


level-js maxogden 
leveldown/leveldb library for browsers usir | 
广 10 v22.4 
> level, leveldb 
level-http2 aaaristo 
女 0 v004 
b, http2, http 
leveldown-mobile obastemur 
ee OB iar Fo Th ol OG edd AAAs UW rib 


真 0 vl.11 


图 8-6 npm 上 的 一 些 第 三 方 LevelDB 包 


8.13 昂贵 的 序列 化 和 反 序 列 化 


一 定 要 记 住 , JSON 操作 是 昂贵 的 阻塞 式 操作 。 在 进程 将 数据 装 进 JSON, 或 从 JSON 中 取出 
数据 时 ， 根 本 做 不 了 别 的 事情 。 大 多 数 序列 化 格式 都 是 如 此 。 所 以 序列 化 操作 一 般 都 是 Web 服 
务 器 上 的 瓶颈 。 要 想 降低 影响 ， 最 好 的 办 法 就 是 减少 这 种 操作 的 频率 和 要 处 理 的 数据 量 。 

改变 序列 化 格式 (比如 MessagePack 或 Protocol Buffer ) 可 能 会 加 快 处 理 速度 ， 但 在 考虑 改 
变 序 列 化 格式 之 前 ， 要 尽 可 能 先 通过 降低 负载 和 优化 序列 化 / 反 序 列 化 步骤 来 改善 性 能 。 

JSON.stringify 和 JsoN.parse 是 原生 困 数 ， 已 经 充分 优化 过 了 ， 但 在 需要 处 理 以 兆 字 
节 为 单位 的 数据 时 , 还 是 很 容易 垮 掉 .下面 演示 一 下 序列 化 和 反 序 列 化 10MB 数据 时 的 性 能 表现 。 


代码 清单 8-22 ”序列 化 的 性 能 基准 测试 
const bytes = require('pretty-bytes'); 
const obj = {}; 
for (let i = 0; i < 200000; i++) { 
obj[i] = { 
[Math.random()]: Math.random() 
> 
} 














jee 





console.time('serialise'); 
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const jsonString = JSON.stringify (obj); 

console.timeEnd('serialise'); 

console.log('Serialised Size', bytes (Buffer.byteLength(jsonSstring))); 
console.time('deserialise'); 

const obj2 = JSON.parse (jsonString); 

console.timeEnd('deserialise'); 


在 一 台 装 了 Node 6.2.2 的 2015 3.1GHZ Intel Core i7MacBook Pro 上 , 对 这 将 近 10MB 的 数据 ， 
序列 化 几乎 用 了 140 毫秒 ， 反 序列 化 用 了 335 毫秒 。 这 样 的 负载 放 到 Web 服务 器 上 就 是 场 灾 难 ， 
因为 这 些 步 又 是 阻塞 式 的， 只 能 串 行 处 理 。 在 序列 化 时 ,这 样 的 服务 器 每 秒 大 概 只 能 处 理 7 个 请 
求 ， 反 序列 化 时 每 秒 只 处 理 3 个 。 


8.14 浏览 器 内 存储 


Node 采 用 的 异步 编程 模型 可 以 适用 于 很 多 场景 ， 因 为 对 大 多 数 Web 程序 来 说 ， 最 大 的 瓶颈 
就 是 IJO。 所 以 利用 客户 端 数据 存储 既 能 降低 服务 器 负载 ， 还 可 以 提升 用 户 体验 ， 这 是 效果 最 显 
著 的 做 法 。 不 用 等 着 程序 在 网 上 跑 来 跑 去 取 数 据 的 用 户 会 很 开心 。 客 户 端 存储 还 可 以 提高 程序 的 
可 用 性 ， 因 为 即便 用 户 或 者 服务 掉 线 了 ， 程 序 里 有 些 功能 还 是 可 以 用 的 。 



























































8.14.1 Web 存储 : localStorage 和 sessionStorage 


Web 存储 定义 了 简单 的 键 / 值 存储 ， 其 在 客户 端 和 移动 端 浏览 器 上 都 有 很 好 的 支持 。 域 可 以 
用 Web 存储 在 浏览 器 里 保存 一 定量 的 数据 ， 即 便 在 经 过 网 站 刷新 、 标 签 页 关闭 ， 甚 至 浏览 器 关 
闭 后 ， 这 些 数据 依然 存在 。Web 存储 是 客户 端 持久 化 的 首选 ， 简 单 朴素 是 它 的 优势 。 

有 两 种 Web 存储 API: localStorage 和 sessionStorage。sessionStorage 的 API 跟 localStorage 
一 样 ， 只 是 持久 化 行为 不 同 。 虽 然 它们 存储 的 数据 在 页 面 重新 加 载 之 后 都 会 得 以 保留 ， 但 
sessionStorage 数据 只 会 保留 到 页 面 会 话 结束 〈 标签 或 浏览 器 关闭 时 )， 并 且 不 能 在 不 同 的 浏览 
窗口 之 间 共 享 。 

开发 Web 存储 API 是 为 了 克服 浏览 器 cookie 的 限制 。 确 切 地 说 ，cookie 不 太 适 合 在 多 个 活 
跃 标签 间 共 享 同一 域 中 的 数据 。 如 果 用 户 要 跨越 多 个 标签 完成 一 项 任务 ， 可 以 用 sessionStorage 
保存 这 些 标签 共享 的 状态 数据 ， 从 而 省 掉 因 网 络 传 输 带 来 的 开销 。 

要 保留 跨越 多 个 会 话 、 标 签 和 窗口 的 长 期 数据 ( 比如 用 户 撰写 的 文档 或 邮件 ) 时 ，cookie 也 
不 好 用 。 设 计 localStorage 就 是 为 了 解决 这 些 问 题 的 。 不 同 浏览 器 有 不 同 的 数据 存储 空间 上 限 。 
移动 端 浏览 右 中 只 有 5MB 的 存储 空间 。 

API 概览 

localStorage API 提供 的 方法 包括 : 
口 localStorage.setIitem(key, value) 







































































存储 键 值 对 ; 
口 1ocalStorage.getItem(key) 获取 指定 键 对 应 的 值 ; 
口 localStorage.removeItem (key) 移 除 指定 键 对 应 的 值 ; 
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口 localStorage.clear() 一 一 移 除 所 有 刍 值 对 ; 
DQ localStorage.key (index) 获取 指定 索引 处 的 值 ; 
口 localstorage.length 一 localStorage 中 的 键 总 数 。 











8.14.2 ” 值 的 读 写 


键 和 值 只 能 是 字符 串 。 如 果 提 供 的 值 不 是 字符 串 ， 会 被 强制 转换 成 字符 串 。 这 种 转换 用 的 
是 .tostring, 不 会 产生 JSON 字符 串 。 所 以 对 象 的 序列 化 结果 就 是 [object object] 。 因 此 ， 
要 想 在 Web 存储 中 存放 比较 复杂 的 数据 类 型 ， 只 能 让 应 用 程序 做 转换 处 理 。 下 面 是 在 localStorage 
中 存放 JSON 的 例子 。 


代码 清单 8-23 ”在 Web 存储 中 存放 JSON 
const examplepreferences = { 
temperature: 'Celcius' 


}; 
































// 写 时 序列 化 
localStorage.setItem('preferences', JSON.stringify (examplePpreferences)); 


// 读 时 反 序列 化 
const preferences = JSON.parse(localStorage.getIitem('preferences')); 
console.log('Loaded preferences:', preferences); 


访问 Web 存储 中 的 数据 是 同步 操作 , 也 就 是 说 在 执行 读 写 操作 时 , Web 存储 会 阻塞 UI 线程 ， 
但 速度 仍然 相当 快 。 在 工作 负载 比较 小 时 ,用 户 甚至 察觉 不 到 这 种 阻塞 ， 但 还 是 要 注意 ,应 该 尽 
量 避 免 过 度 读 写 ， 尤 其 要 避免 出 现 大 量 数据 的 读 写 操作 。 可 异 Web worker 无 法 访问 Web 存储 ， 
所 以 所 有 读 写 只 能 在 主 UI 线 程 中 进行 。PouchDB 的 作者 Nolan Lawson 写 过 一 篇 文章 ,详细 分 析 
了 各 种 客户 端 存储 技术 对 性 能 的 影响 ， 读 者 可 以 在 他 的 博客 上 搜索 关键 字 找 到 这 篇 文章 。 

Web 存储 API 没有 查询 操作 ,也 不 能 按 范围 选择 键 , 或 者 搜索 特定 的 值 ， 只 能 通过 键 来 访问 
数据 项 。 如 果 想 实现 搜索 功能 ， 只 能 自己 维护 一 套 索 引 ; 或 者 数据 集 非常 小 的 话 ， 可 以 进行 循环 
遍历 。 下 面 就 是 对 localStorage 中 的 所 有 键 进 行 循环 遍历 的 代码 。 


代码 清单 8-24 ”循环 遍历 localStorage 中 的 整个 数据 集 


function getAllKeys() { 
return Object.keys (localStorage); 












































} 


function getAllKeysAndValues() { 
return getAllKeys() 
"Leduee( (Obi Ek). > 
obj[str] = localStorage.getItem(str); 
return obj; 


}, {}); 
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// 得 到 所 有 的 值 
const allValues = getAllKeys() .map (key => localStorage.getItem(key)); 


// 作为 对 象 输出 

console.log(getAllKeysAndValues ()); 

跟 大 多 数 键 / 值 存储 一 样 ，Web 存储 中 的 键 也 只 有 一 个 命名 空间 。 比 如 说 ， 我 们 不 能 分 别 为 
posts 和 Comments 创建 各 自 的 存储 。 不 过 可 以 通过 给 键 增加 前 级 的 方式 创建 “命名 空间 ”， 比 
如 像 下 面 这 样 。 


代码 清单 8-25 ” 键 的 命名 空间 
localStorage.setIitem( /posts/${post.id}., post); 
localStorage.setItem( /comments/$s{comment.id}., comment); 


要 获取 某 个 命名 空间 下 的 所 有 数据 项 , 可 以 通过 getAllKeys 哺 数 进行 过 滤 , 代码 如 下 所 示 。 
代码 清单 8-26 ”获取 某 个 命名 空间 中 的 所 有 数据 项 


function getNamespaceItems (namespace) { 
return getAllKeys().filter(key => key.startsWith (namespace)); 


} 


console.log(getNamespaceItems('/exampleNamespace')); 


这 样 会 循环 遍历 localStorage 中 的 所 有 键 ， 所 以 如 果 数 据 项 比较 多 ， 要 考虑 一 下 对 性 能 的 影响 。 

因为 localStorage API 是 同步 的 ， 所 以 用 起 来 限制 还 是 比较 多 的 。 比 如 说 ， 对 于 那些 以 JSON 
序列 化 数据 为 参数 ， 并 且 返 回 结果 也 是 这 样 的 数据 的 函数 ， 你 可 能 会 用 localStorage 绥 存 记忆 
( memoize ) 它 的 返回 结果 。 
代码 清单 8-27 用 localStorage 持久 化 记忆 

// 以 后 调用 时 如 果 参 数 相 同 ， 可 以 直接 返回 之 前 记 住 的 结果 


function memoizedExpensiveOperation(data) { 



























































const key = ‘/memoized/${JSON.stringify (data)}; 
const memoizedResult = localStorage.getIiteml(key); 
if (memoizedResult != null) return memoizedResult; 


// 完成 高 成 本 工作 

const result = expensiveWork (data); 

// 将 结果 保存 到 localStorage 中 ， 以 后 就 不 用 再 计算 了 
localStorage.setIitem(key, result); 

return result; 


} 

不 过 只 有 操作 特别 慢 时 ， 记 住 结果 的 收益 才 会 大 于 序列 化 / 反 序 列 化 处 理 的 开销 ( 比如 加 密 
算法 )。 因 此 最 好 是 用 localStorage 节省 因为 要 在 网 络 上 传输 数据 而 开销 的 时 间 。 

Web 存储 确实 会 受到 限制 , 但 只 要 使 用 得 当 , 依然 是 简单 而 又 强大 的 工具 。 接 下 来 要 研究 的 















































浏览 器 中 存储 是 : 
口 IndexedDB 
口 服务 人 员 
D 离线 优先 
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8.14.3 localForage 
Web 存储 最 主要 的 缺点 就 是 它 的 阻塞 式 同步 API 和 在 某 些 浏 览 器 中 有 限 的 存储 空间 。 除 了 


Web 存储 ， 大 多 数 现 代 浏 览 器 都 会 支持 WebSQL 或 IndexedDB，, 或 者 同时 支持 两 种 存储 。 它 们 都 
是 非 阻 塞 的 ， 并 且 存 储 空间 比 Web 存储 大 得 多 。 








但 建议 不 要 像 
提供 的 API 既 不 友 

















用 Web 存储 那样 直接 用 。WebSQL 已 经 被 废弃 了 ， 而 它 的 继任 者 IndexedDB， 
好 也 不 简洁 , 更 别提 那 拼 凑 出 来 的 浏览 器 支持 了 。 要 想 在 浏览 器 中 用 非 阻塞 的 








方式 存储 数据 ， 而 且 还 要 方便 可 靠 ， 我 们 推荐 一 种 “标准 化 的 ” 非 标 配 工具 ， 其 来 自 Mozilla 的 
localForage 库 ( http://mozilla.github.io/localForage/ ) 


API 概览 


























localForage 的 接口 基本 上 跟 Web 存储 一 模 一 样 ， 只 不 过 是 异步 非 阻塞 方式 的 : 


DOODOD 
避 
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8.14.4” 读 和 写 


D localforage.setIitem(key, value, callback) 


存储 键 值 对 ; 





Jocalforade.getILem(key， callback) 一 一 获取 指定 键 的 值 ; 
localforage.removelItem(key, callback) 一 一 移 除 指定 键 的 值 ; 
lforage.clear (callback) 一 一 移 除 所 有 的 键 值 对 ; 
localforage.key (index, callback) 一 一 获取 指定 索引 的 值 ; 
localforage.length (callback)——localForage 中 键 的 总 数 。 
localForage API 中 还 额外 增加 了 一 些 Web 存储 中 没有 的 功能 : 

口 localforage.keys (callback) 一 一 获取 所 有 的 键 ; 
口 localforage.iterate (iterator,callback) 一 一 循环 遍历 键 值 对 。 

















localForageAPI 有 promise 和 回调 两 种 方式 。 


代码 清单 8-28 1localStorage 和 localForage 的 数据 读 取 


const value = localStorage.getIitem(key); 


3 localStorage: 


console.log(value); 同步 阻塞 


localforage.getItem(key) 
.then(value => console.log(value)); 


localforage.getItem(key, (err, value) => { 
console.log(value); 


} 


localForage: 使 用 promise 


的 异步 非 阻塞 方式 


S localForage: 
使 用 回调 的 异 
; 步 非 阻塞 方式 





localForage 会 在 底层 使 用 当前 浏览 器 环境 中 最 好 的 存储 机 制 。 如 果 有 IndexedDB ， 就 用 
IndexedDB。 否 则 就 试 着 用 WebSQL， 其 至 用 Web 存储 。 这 些 存 储 的 优先 级 是 可 以 配置 的 ， 甚 至 
可 以 禁止 使 用 某 种 存储 ; 这 样 就 永远 不 会 尝试 用 


// 比 如 不 用 localStorage 

















localStorage 了 


localforage.setDriver([localforage.INDEXEDDB,1ocalforage.WEBSQOL]); < 
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localForage 可 以 存储 字符 串 之 外 的 其 他 类 型 的 数据 。 它 支持 大 多 数 的 JavaScript 原始 类 型 ， 
比如 数组 和 对 象 ， 以 及 二 进 制 数据 类 型 TryvpedqArray、ArrayBuffer 和 Blob。IndexedDB 是 
唯一 支持 二 进 制 数据 存储 的 后 台 ， 也 就 是 说 如 果 后 台 用 的 是 WebSQL 和 localStorage， 会 有 编组 
开销 : 
Promise.all([ 
localforage.setItem('number', 3), 
localforage.setItem('object', { key: 'value' }), 


localforage.setIitem('typedarray', new Uint32Array ([1,2,3])) 
] :2 


将 API 做 成 跟 Web 存储 一 样 让 localForage 用 起 来 更 简单 , 也 解决 了 很 多 缺点 和 兼容 性 问题 。 


8.15 存储 托管 


使 用 存储 托管 不 需要 管理 自己 的 服务 器 端 存储 。 像 Amazon Web 服务 ( AWS ) 这 样 的 厂商 提 
供 的 那些 托管 式 基 础 设施 一 般 仅 作为 扩展 和 性 能 优化 方案 , 但 在 早期 巧 用 这 些 托管 式 服 务 可 以 免 
于 实现 不 必要 的 基础 设施 ， 从 而 节省 大 量 时 间 。 

即便 不 是 全 部 , 也 能 找到 本 章 中 列 出 的 大 部 分 数据 库 的 托管 式 服务 。 使 用 托管 式 服 务 可 以 迅 
速 尝试 各 种 工具 , 甚至 无 须 搭建 自己 的 数据 库 主 机 就 能 部 署 对 外 开放 的 生产 程序 。 但 部 署 自己 的 
数据 存储 越 来 越 简单 了 。 很 多 云 服 务 提供 商都 有 预先 配置 好 的 服务 器 映像 , 安装 了 运行 所 选 数据 
库 所 需 的 全 部 软件 ， 并 且 全 都 配置 好 了 。 


简单 存储 服务 


Amazon 的 简单 存储 服务 ( S3 ) 是 一 种 远程 文件 托管 服务 ， 包 含 在 大 受 欢 迎 的 ASW 包 中 。 
用 S3 存储 和 托管 向 网 络 开放 的 文件 有 成 本 上 的 优势 。 它 是 云端 的 文件 系统 。 可 以 用 RESTful HTTP 
调用 将 文件 和 不 超过 2KB 的 元 数据 上 传 到 桶 中 。 然 后 通过 HTTP GET 或 BitTorrent 协议 访问 这 些 
内 容 。 

我 们 可 以 对 桶 及 其 中 的 内 容 进行 各 种 访问 许可 配置 , 包括 基于 时 间 的 访问 。 还 可 以 给 桶 里 的 
内 容 指定 一 个 生存 期 (TTL )， 生 存 期 过 了 之 后 就 会 从 桶 中 删 措 ， 再 也 访问 不 到 。 将 S3 数据 提升 
到 内 容 交 付 网 络 (CDN ) 中 也 很 容易 。AWS 提供 了 CloudFront CDN, 可 以 轻松 连接 到 你 的 文件 ， 
然后 用 很 低 的 延 时 提供 给 全 世界 。 

并 不 是 所 有 的 数据 都 需要 存 到 数据 库 中 。 你 的 数据 中 是 不 是 有 些 应 当 作 为 文件 ? 在 为 用 户 生 
成 了 一 个 昂贵 的 计算 结果 后 ， 也 许 应 该 将 这 些 结果 推送 到 S3 上 ， 再 也 不 用 重 趴 覆 略 。 

S3 经 常用 来 存储 用 户 上 传 的 图 片 等 资源 性 文件 。 要 上 传 的 资源 性 文件 先是 放 在 程序 所 在 机 
器 的 一 个 临时 目录 中 ， 然 后 用 ImageMagick 这 样 的 工具 缩小 之 后 上 传 到 S3 ， 以 供 浏 览 器 访问。 
如 果 通 过 流 直接 上 传 到 S3 ， 这 个 过 程 就 更 简单 了 ,到 达 S3 之 后 还 可 以 触发 后 续 处 理 。 客 户 端 程 
序 也 可 以 直接 上 传 到 S3。 一 些 面向 开发 人 员 的 服务 甚至 要 求 用 户 提供 他 们 的 S3 桶 访问 令 牌 ， 实 

















































































































































































































现 绝对 的 零 存储 。 

S3 并 不 是 只 能 存储 图 片 

S3 可 以 存储 任何 文件 ， 只 要 不 超过 5TB， 任 何 格式 都 可 以 。 在 处 理 要 作为 一 个 整体 来 访问 
的 、 不 怎么 变化 的 大 块 数据 时 ，S3 的 表现 最 好 。 

安装 和 维护 文件 托管 及 存储 服务 器 是 个 比较 复杂 的 任务 ， 把 数据 放 到 S3 上 可 以 避 开 这 些 麻 
烦 。 对 于 那些 需要 作为 一 个 整体 访问 的 大 块 数据 来 说 ,只 要 写 的 次 数 不 频 繁 , 并 且 可 能 需要 从 多 
个 位 置 进行 很 多 次 访问 ， 就 非常 适合 放 到 S3 上 。 


8.16 选 哪个 数据 库 


本 章 只 介绍 了 Node 程序 中 常用 的 几 个 数据 库 。 用 这 些 数据 库 中 的 任何 一 个 都 能 搭建 出 成 功 
的 应 用 程序 ， 并 且 不 乏 先例 。 但 并 不 是 总 能 为 程序 找到 理想 的 数据 存储 方案 。 没 有 银 弹 。 每 个 数 
据 库 都 有 自己 独特 的 折 中 方案 , 开发 人 员 要 评估 哪 种 折 中 方案 最 适合 项 目 当 前 的 状态 。 一 般 来 说 
采用 混合 技术 是 最 合适 的 。 

与 其 问 “ 我 应 该 用 什么 数据 库 ”， 不 如 问 “ 如 果 根 本 不 用 数据 库 ， 我 能 坚持 多 久 ”。 你 能 用 长 
期 有 效 的 决策 做 多 少 个 项 目 ? 以 后 再 做 决定 一 般 就 是 最 好 的 决定 , 等 你 以 后 有 了 更 多 信息 时 , 总 
能 做 出 更 好 的 决定 。 



















































































8.17 总 结 








口 Node 既 能 用 关系 型 数据 库 ， 也 能 用 NoSQL 数据 库 。 
口 简单 的 pg 模块 很 擅长 处 理 SQL 语言 。 

口 Knex 模块 可 以 使 用 几 个 数据 库 。 

口 ACID 是 一 组 数据 库 事务 属性 ， 可 以 确保 安全 性 。 

口 MongoDB 是 使 用 JavaScript 的 NoSQL 数据 库 。 

口 Redis 是 可 以 当 作 数据 库 和 缓存 用 的 数据 结构 化 存储 。 

口 LevelDB 是 源 自 Google 的 高 速 键 / 值 对 存储 ， 可 以 将 字符 串 映 射 到 值 。 

口 LevelDB 是 模块 化 数据 库 。 

口 基于 Web 的 存储 ， 包 括 localForage 和 localStorage， 可 以 将 数据 保存 在 浏览 器 中 。 
口 可 以 用 Amazon S3 这 样 的 存储 服务 把 数据 保存 到 云 提 供 商 那里 。 

































































测试 Node 程序 








本 章 内 容 

口 用 Node 的 assert 模块 测试 

口 使 用 其 他 断言 库 

口 使 用 Node 单元 测试 框架 

口 用 Node 模拟 并 控制 Web 浏览 
口 在 测试 失败 时 获取 更 多 信息 




















添加 到 程序 中 的 功能 越 多 ,出现 bug 的 风险 就 越 高 。 没 经 过 测试 的 程序 是 不 完整 的 ， 而 手动 
测试 既 繁 琐 又 容易 出 错 ， 所 以 自动 测试 越 来 越 受 欢迎 。 自 动 测试 是 指 编写 代码 来 测试 代码 ， 而 不 
是 手动 运行 程序 中 的 功能 。 

如 果 之 前 没 接触 过 , 那么 可 以 把 自动 测试 当 作 机 器 人 , 它 会 帮 你 做 那些 乏味 的 工作 ,你 则 可 
以 把 精力 放 在 有 趣 的 事情 上 。 这 个 机 器 人 可 以 确保 你 修改 代码 时 不 会 有 bug 激进 来 。 尽管 你 可 能 
还 没完 成 或 开始 第 一 个 Node 程序 ， 但 这 并 不 妨碍 你 掌握 如 何 实现 自动 测试 ， 因 为 可 以 边 开发 边 
写 测试 代码 。 

本 章 会 介绍 两 种 自动 测试 : 单元 测试 和 验收 测试 。 单 元 测试 直接 测试 代码 逻辑 ,通常 是 在 函 
数 或 方法 层面 , 适用 于 所 有 类 型 的 程序 。 单元 测试 方法 可 以 分 为 两 大 形态 ; 测试 驱动 开发 (TDD ) 
和 行为 驱动 开发 (BDD )。 实 事 求 是 地 讲 ，TDD 和 BDD 基本 是 一 样 的 ， 它 们 的 区 别 主 要 体现 在 
风格 上 。 这 个 是 否 重要 取决 于 阅读 测试 的 人 是 谁 。TDD 和 BDD 还 有 其 他 区 别 , 但 那 不 在 本 书 的 
讨论 范围 之 内 。 验 收 测试 一 般 是 对 Web 程序 进行 的 额外 测试 ,需要 用 脚本 控制 浏览 器 来 触发 Web 
程序 的 功能 。 

本 章 会 介绍 成 熟 的 单元 和 验收 测试 方案 。 对 于 单元 测试 ， 我 们 会 介绍 Node 的 assert 模块 ， 
Mocha、Vows、Shouldjs 框架 和 Chai。 对 于 验收 测试 , 我 们 会 看 一 下 如 何在 Node 中 使 用 Selenium。 
图 9-1 把 这 些 工具 和 它们 各 自 的 测试 方法 及 风格 放 到 了 一 起 。 
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测试 程序 逻辑 测试 程序 界面 和 功能 


单元 测试 验收 测试 
TDD BDD 浏览 器 2 























有 千 了 T 
Mocha Mocha WebdriverIO WebdriverIO 
Jasmine Vows Selenium Phantom 
Node 的 assert 模 块 Chai Zombie.js 
Chai Should.js 


图 9-1 测试 框架 概览 

















O 


我 们 先 从 单元 测试 开始 吧 


9.1 单元 测试 


单元 测试 是 指 通 过 编写 代码 来 测试 程序 中 的 各 个 部 分 。 编 写 测试 代码 会 让 你 更 认真 地 思考 
程序 的 设计 选择 ,尽早 避 开 各 种 陷阱 。 测 试 还 让 你 确信 自己 最 近 所 做 的 修改 没有 引入 错 误 。 尽 管 
单元 测试 需要 在 编码 前 做 些 工作 , 但 以 后 每 次 修改 程序 后 都 不 用 再 手动 测试 了 , 所 以 还 是 能 节省 
很 多 时 间 的 。 

做 单元 测试 需要 些 技巧 ， 而 异步 逻辑 又 带 来 了 新 的 挑战 。 因 为 异步 单元 测试 可 以 并 行 运行 ， 
所 以 必须 小 心 ， 确 保 测 试 不 会 相互 干扰 。 比 如 说 ， 如 果 测 试 在 硬盘 上 创建 了 一 个 临时 文件 ， 那 
么 在 完成 测试 后 删除 文件 时 一 定 要 并 愤 , 以 免 删 掉 另 外 一 个 未 完成 的 测试 正在 使 用 的 文件 。 因 此 
很 多 单元 测试 框架 都 有 流程 控制 ， 可 以 让 测试 按 顺 序 运行 。 

本 节 会 介绍 如 何 使 用 : 
口 Node 自 带 的 assert 模块 一 一 TDD 风格 自动 化 测试 的 好 工具 ; 
口 Mocha 一 一 相对 比较 新 的 测试 框架 ， 可 以 用 来 做 TDD- 或 BDD- 风 格 的 测试 ; 
口 Vows 一 一 得 到 广泛 应 用 的 BDD 风格 测试 框架 ; 
口 Should.js 一 一 构建 在 Node assert 模 块 之 上 的 模块 ， 提 供 BDD 风格 的 断言 。 
下 一 节 将 会 演示 如 何 用 assert 模块 测试 业务 逻辑 ， 这 是 Node 自 带 的 模块 。 






















































































9.1.1 assert 模块 

assert 模块 是 Node 中 大 多 数 单元 测试 的 基础 ， 它 可 以 测试 一 个 条 件 ， 如 果 条 件 未 满足 则 抛 
出 错误 。 很 多 第 三 方 测试 框架 都 用 到 了 assert 模块 ， 甚 至 没有 测试 框架 也 可 以 用 它 做 测试 。 如 果 
你 忽然 冒 出 来 一 个 想法 ， 单 靠 assert 模块 就 可 以 试 着 验证 一 下 。 
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1. 一 个 简单 的 例子 











假设 有 一 个 简单 的 待 办 事项 程序 ， 它 把 事项 存在 内 存 里 ， 而 你 要 断言 它 做 的 是 你 认为 它 在 





做 的 。 





下 面 这 个 代码 清单 中 定义 的 模块 实现 了 程序 的 核心 功能 ， 包 括 待 办 事项 的 创建 、 获取 和 删 
除 。 它 还 包括 一 个 简单 的 soasyne 方法 ， 所 以 你 还 能 看 到 如 何 测试 异步 方法 。 将 这 段 代码 保存 








到 todo.js 中 。 
代码 清单 9-1 待 办 事项 列表 的 模型 


class Todo { 





constructor() { 定义 待 办 事 
this.todos = []; < 项 数据 库 
添加 待 办 
add(item) { 事项 


if (!item) throw new Error('Todo.prototype.add requires an item'); 
this.todos.push (item); 
} 





deleteAll() { < 
中 除 
thigs.,todos. .= [3 | 
) 5 贝 
get lengthn() { 取得 待 办 事 
return this.todos.length; 项 的 数量 
. a 
doAsync (cb) { < 一 一 小 乒 奉 差 和 9 
SetTimeout (ch, 2000, true); Re eee Saas 
目 目 
} 
输出 Todo 
module.exports = Todo; < 一 函数 








接 下 来 用 assert 模块 测试 这 段 代 码 。 下 面 的 代码 加 载 了 必需 模块 , 创建 了 新 的 待 办 二 
还 声明 了 一 个 变量 记录 完成 的 测试 数量 。 将 它 保存 为 testjs。 


代码 清单 9-2 设置 必需 模块 
const assert = require('assert'); 
const Todo = require('./todo'); 
const todo = new Todo(); 
let testsCompleted = 0; 


2. 用 equal 检查 变量 的 值 
接 下 来 测试 待 办 事项 程序 的 删除 功能 。 将 下 面 的 代码 加 到 testjs 的 末尾 处 。 
代码 清单 9-3 ”测试 以 确保 删除 后 未 留 下 待 办 事项 
添加 用 来 测试 删 


function deleteTest() { 除 的 数据 
todo.add('Delete Me'); i 











项 列表 ， 
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断言 数据 添 
assert.equal (todo.length, 1, '1 item should exist'); 二 加 成 功 
todo.deleteAll (); 
< 1 
at assert.equal (todo.length, 0, 'No items should exist'); 
部 删除 “ie 
testsCompleted++; 记录 测试 已 断言 记录 删 
) 完成 除 成 功 





这 个 测试 先 添 加 了 一 个 待 办 事项 ， 然 后 再 删 掉 ， 所 以 最 后 应 该 没有 待 办 事项 。 如 果 程 序 能 正常 
工作 , 那么 todo.1length 的 值 应 该 是 0。 如 果 程 序 出 了 问题 ， 则 会 有 异常 抛 出 。 如 果 togo.1length 
不 是 0， 那么 这 个 断言 会 在 栈 跟 踪 中 显示 一 条 错误 消息 ， 在 控制 台中 输出 “No items should exist”。 
在 断言 后 面 将 testscompleted 加 一 ， 记 录 已 经 完成 了 一 项 测试 。 

3. 用 notEqual 找 出 逻辑 中 的 问题 

把 下 面 的 代码 添加 到 testjs 中 。 这 段 代 码 测试 的 是 待 办 事项 程序 的 添加 功能 。 


代码 清单 9-4 ”测试 以 确保 待 办 事项 添加 正常 


























function addTest() { 删除 之 前 所 
todo.deleteAll(); < 有 的 事项 添加 事项 
todo.add('Added'); 站 
assert.notEqual (todo.getCount(), 0, '1 item should exist'); 
testsCompleted++; 二 一] 记录 测试 断言 有 事项 
) 存在 


已 完成 

assert 模块 中 还 有 个 notEqual 断言 。 当 程序 产生 特定 的 值 表 明 逻 辑 有 问题 时 ， 可 以 采用 这 
种 断言 。 代 码 清单 9-4 展示 了 notEqual 断言 的 用 法 。 在 删除 了 所 有 的 待 办 事项 后 又 添加 了 一 个 
事项 ， 然 后 再 获取 所 有 事项 。 如 果 事 项 的 数量 为 0， 断言 就 会 失败 并 抛 出 异常 。 

4. 其 他 功能 : strictEqual、notStrictEqual、deepEqual、notDeepEqual 

除了 equal 和 notEqual, assert 模 块 还 提供 了 更 严格 的 版 本 : strictEqual 和 notstrictEqual。 
它们 在 进行 判断 时 用 的 是 严格 的 相等 操作 符 ===， 而 不 是 比较 随和 的 ==。 

assert 模块 也 有 用 来 比较 对 象 的 deepEqual 和 notDeepEqual。 这 些 断 言 中 的 deep 表明 它 
们 会 层 层 深入 地 对 两 个 对 象 进行 比较 ， 比 较 两 个 对 象 的 属性 ， 如 果 属 性 也 是 对 象 ， 则 会 继续 比较 

5. 用 ok 测试 异步 值 是 否 为 true 

现在 该 测试 goAsync 方法 了 ， 如 代码 清单 9-5 所 示 。 因 为 是 异步 测试 ， 所 以 要 提供 一 个 回调 函 
数 (cp) ， 向 测试 运行 者 发 送 测试 结束 的 信号 一 一 不 能 像 同 步 测 试 那样 靠 返回 语句 来 表明 测试 结 
了 。 要 判断 doasync 的 结果 值 是 否 为 true， 可 以 用 ok 断言 。 用 它 判 断 一 个 值 是 否 为 true 很 容易 。 


代码 清单 9-5 ”判断 aoasync 回调 传人 的 是 否 为 true 


function doAsyncTest (cb) { 

















































































































todo.doAsync (value => { < 一 一 两 秒 后 激 
断言 值 为 assert.ok(value, 'Callback should be passed true'); 活 回调 
> 目 
true testsCompleted++; 记录 测试 
cp0; 完成 后 触发 已 完成 


a 回调 函数 
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6. 测试 能 否 正确 抛 出 错误 
assert 模块 还 可 以 检查 程序 抛 出 的 错误 消息 是 否 正 确 ， 代 码 如 下 所 示 。throws 调用 中 的 第 
二 个 参数 是 一 个 正则 表达 式 ， 表 示 要 在 错误 消息 中 查找 文本 requires。 











代码 清单 9-6 ”检查 缺少 参数 时 ada 是 否 会 抛 出 错误 


function throwsTest (cb) { 


assert.throws (todo.add, /requires/); 没有 参数 的 todo.adq 
testsCompleted++; “| 记录 测试 已 调用 
} 完成 


7. 运行 测试 
测试 已 经 定义 好 了 , 接 下 来 要 在 测试 文件 中 添加 运行 这 些 测试 的 代码 。 下 面 的 代码 会 运行 前 
面 定义 的 所 有 测试 ， 然 后 输出 完成 的 测试 数量 。 


代码 清单 9-7 运行 测试 并 报告 测试 完成 的 数量 





deleteTest (); 

addTest () ; 

throwsTest (); 

doAsyncTest (() => { 表明 完 
console.log(‘Completed S${testsCompleted} tests 、 ) ; 十 一 一 成 数 


站 

用 下 面 的 命令 运行 这 些 测试 : 

$s node chapter09-testing/listing_ 09_1-7/test.js 

如 果 测 试 都 成 功 了 ,这 段 脚本 会 告诉 你 已 完成 的 测试 数量 。 要 防止 某 个 测试 出 问题 ,可 以 追 
踪 测 试 的 开始 和 结束 时 间 。 比 如 说 ， 某 个 测试 可 能 没 能 执行 到 断言 的 地 方 。 

使 用 Node 自 带 的 assert 模块 时 ， 每 个 测试 用 例 中 都 要 包含 很 多 套路 化 的 代码 用 以 设置 测试 
(比如 删除 所 有 事项 )， 追 踪 测 试 进程 (“已 完成 ”计数 器 ) 等 。 这 些 套路 化 的 代码 会 占用 你 编写 
测试 用 例 的 时 间 和 精力 ， 如 果 能 把 这 些 工 作 交 给 专用 框架 ， 让 你 能 把 精力 都 放 在 业务 逻辑 的 测 
试 上 岂 不 更 好 。 接 下 来 我 们 要 看 一 看 Mocha, 了 解 一 下 如 何 用 这 个 第 三 方 单元 测试 框架 让 工作 变 
得 更 轻松 。 

































































9.1.2 Mocha 


Mocha 是 个 流行 的 测试 框架 , 很 容易 上 手 。 尽 管 Mocha 默认 是 BDD 风格 的 , 但 也 可 以 用 在 
TDD 风格 的 测试 中 。Mocha 具有 多 种 特性 ， 包 括 全 局 变量 泄漏 检测 和 客户 端 测 试 。 














全 局 变量 泄漏 检测 
一 般 应 该 不 需要 整个 程序 范围 内 全 都 梧 读 的 全 局 变量 ,并 且 按 照 编程 最 佳 实践 来 说 ， 要 尽 
量 少 用 全 局 变量 。 但 在 ES5 中 ， 一 不 小 心 就 会 创建 一 个 全 局 变量 出 来 ， 只 要 在 声明 变量 时 忘 
记 写 关键 字 var, 这 个 变量 就 是 全 局 变量 了 。Mocha 能 发 现 这 种 不 小 心 创建 出 来 的 全 局 变量 汇 
漏 ， 如 果 你 创建 了 全 局 变量 ， 它 会 在 测试 时 抛 出 错误 。 
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如 果 想 禁用 全 局 泄漏 检测 ， 可 以 在 运行 mocha 命令 时 加 上 --ignored-leaks 选项 。 此 
外 ， 如 果 想 指明 要 用 的 几 个 全 局 变量 ， 可 以 把 它们 放 在 --globals 选项 后 面 ， 用 过 号 分 开 。 


Mocha 测试 默认 使 用 BDD 风格 的 函数 定义 和 设置 , 这 些 函 数 包 插 describe、 it、before、 
after、beforeEach 和 afterEach。 另 外 , Mocha 也 有 TDD 接口 ,用 suite 代替 aescribe， 
test 代替 it，setup 代替 before，teardown 代替 after。 不 过 在 我 们 的 例子 中 用 的 还 是 默 
认 的 BDD 接口 。 

1. 用 Mocha 测试 Node 程序 

我 们 继续 。 接 下 来 要 创建 一 个 名 为 memdb (一 个 小 型 的 内 存 数据 库 ) 的 小 项 目 ， 看 看 如 何 
用 Mocha 对 它 进行 测试 。 先 创建 项 目的 目录 和 文件 : 






































mkdir -p memdb/test 

cd memdb 

touch index.js 

touch test/memdb.js 

npm init -y 

npm install --save-dev mocha 


$ 
$ 
$ 
$ 
$ 
$ 





打开 packagejson， 添 加 定义 测试 运行 方式 的 scripts 属性 : 


velit 
"test": "mocha" 





} 


测试 会 放 在 test 目录 下 。Mocha 默认 使 用 BDD 接口 , 代码 如 下 所 示 ( 随 书 源码 见 chapter09- 
testing/memdb )。 


代码 清单 9-8 Mocha 测试 的 基本 结构 
const memdb = require('..'); 
describe('memdb', () => { 
describe('.saveSync(doc)', () => { 
it('should save the document', () => { 


} 
和 9 
}); 
Mocha 也 支持 TDD 和 qunit， 以 及 exports 风格 的 接口 ,项 目 网 站 上 对 此 有 详细 介绍 (https:// 
mochajs.org/ )。 比 如 下 面 就 是 一 个 exports 接口 的 例子 : 














module.exports = { 
'memdb': { 
'.saveSync (doc)': { 


'should save the document': () => { 
; 
} 
} 
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这 些 接口 提供 的 功能 都 是 一 样 的 ， 我 们 依然 是 用 默认 的 BDD 接口 。 下 面 是 第 一 个 测试 ， 代 


码 放 在 test/memdb.js 中 。 这 个 测试 用 到 了 assert 模块。 


代码 清单 9-9 ”描述 memdb. save 的 功能 


const memdb = require('..'); 


const assert = require('assert'); 描述 memab 
descripe('memdb', () => { < 功能 
describe('.saveSync(doc)', () => { < 
描述 期 it('should save the document', () => { 描述 .savesync() 
望 值 const pet = { name: 'Tobi' }; 方法 的 功能 





memdb.saveSync (pet); 
const ret = memdb.first({ name: 'Tobi' }); 


assert (ret == pet); 确保 找到 了 
人 Pet 


执行 npm test 就 可 以 运行 这 些 测试 。Mocha 默认 会 执行 ./test 目录 下 的 JavaScript 文件 。 





为 .savesync() 方 法 还 没 实现 ， 所 以 测试 失败 了 ， 如 图 9-2 所 示 。 





wavded@dev: */Projects/memdb Ee 


wavded@ ~/Projects/memdb» mocha 


xX 1 of 1 test failed: 


1) memdb .save(doc) should save the document: 
TypeError: Object #<0bject> has no method 'save’ 
at Context.<anonymous> (/home/wavded/Projects/memdb/test/memdb.js:8:13) 
at Test.Runnable.run (/usr/local/lib/node_modules/mocha/lib/runnable.js:184:32) 
at Runner.runTest (/usr/local/lib/node_modules/mocha/lib/runner.js:300:10) 
at Runner.runTests.next (/usr/local/lib/node_modules/mocha/lib/runner.js:346:12) 
at next (/usr/local/lib/node_modules/mocha/lib/runner.js:228:14) 
at Runner.hooks (/usr/local/lib/node_modules/mocha/lib/runner.js:237:7) 
at next (/usr/local/lib/node_modules/mocha/lib/runner.js:185:23) 
at Runner.hook (/usr/local/lib/node_modules/mocha/lib/runner.js:205:5) 
at process.startup.processNextTick.process._tickCallback (node.js:244:9) 





Wavdede ~/Projects/memdb» _ 


图 9-2” ”Mocha 中 失败 的 测试 
把 下 面 的 代码 放 到 index.js 中 。 让 测试 成 功 通 过 ! 
代码 清单 9-10 添加 savesync 功能 


const db [了 











exports.saveSync = (doc) => { 将 doc 添加 到 数 
db.push (doc); < 据 库 数 组 中 
9 
exports.first = (obj) => { 选择 跟 obj 的 所 有 
return db.filter((doc) => { < 属性 相 匹 配 的 aoc 
for (let key in obj) { 
if (doc[key] != obj[key]) { 


-| 不 匹配 , 返回 false， 
不 选择 这 个 doc 
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return false; 


} 


i 全 都 匹配 ,返回 并 
return true; < 一 选择 这 个 aoc 

et < 了 一] 只 要 第 一 个 

doc 或 null 


用 npm 再 次 运行 测试 ， 结 果 应 该 如 图 9-3 所 示 ， 成 功 了 。 





wavded@dev: /Projects/memdb x 
lwavded@ ~/Projects/memdb» mocha 


1 test complete (2ms) 





lwavded@ ~/Projects/memdb» _ 








图 9-3 ”Mocha 中 成 功 的 测试 


2. 用 Mocha 挂钩 定义 设置 和 清理 逻辑 

为 代码 清单 9-10 中 的 测试 用 例假 定 memab .first () 可 以 正常 工作 , 所 以 也 要 给 它 添加 几 
个 测试 用 例 。 修 改 后 的 test 文 件 ( 代码 清单 9-11 ) 用 到 了 一 个 新 概念 一 一 Mocha 挂钩 。 BDD 接 
口 beforeEach()、afterEach()、before() 和 after() 接 受 回 调 , 可 以 用 来 定义 设置 和 清理 
逻辑 。 
代码 清单 9-11 添加 beforeEach 挂钩 


const memdb = require('..'); 

















const assert = require('assert'); 
describe('memdb', () => { 
beforeEach(() => { 在 每 个 测试 用 例 之 前 都 要 清理 数 
memdb.clear (); 了 据 库 ， 保 持 测试 的 无 状态 性 
}); 
describe('synchronous .saveSync(doc)', () => { 
it('should save the document', () => 
const pet = { name: 'Tobi' }; 


memdb.saveSync (pet); 
const ret = memdb.first({ name: 'Tobi' }); 





assert (ret == pet); 
sy 
} 
describe('.first(obj)', () => { 对 .first() 的 
it('should return the first matching doc', () => { < 第 一 个 期 望 
Const toBi = {Tame “ToBi 
const loki = { name: 'Loki' }; 
个 memdb.saveSync (tobi); 
2 2 memdb.saveSync (loki); 确保 每 个 都 可 
let ret = memdb.first({ name: 'Tobi' }); < 一 一 以 正确 返回 
assert (ret == tobi); 


ret = memdb.first({ name: 'Loki' }); 
assert (ret == loki); 
be 
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it('should return null when no doc matches', () => { < 一 一 
const ret = memdb.first({ name: 'Manny' }); 对 .first() 的 
assert (ret, == NM11); 第 二 个 期 望 





es 
上) 全 
3 
理想 情况 下 ， A eis 一 状态 ， 只 需要 在 index.js 
中 实现 .clear () 方 法 来 移 除 所 有 文档 就 行 


exports.clear = () => { 
db.length = 0; 
}; 
再 次 运行 测试 ， 应 该 看 到 三 个 都 通过 了 。 
3. 测试 异步 逻辑 
我 们 还 没 用 Mocha 测试 过 异步 逻辑 。 为 了 演示 如 何 做 这 样 的 测试 ， 要 对 之 前 在 index.js 
义 的 一 个 函数 做 个 小 改动 。 把 savesync 函数 变 成 下 面 这 样 , 加 一 个 会 在 短暂 的 延迟 之 后 执行 
回调 ( 用 来 模拟 某 种 异步 操作 ) 作为 可 选 的 参数 : 



































exports.save = (doc, cb) => { 
db.push (doc); 
if (cb) { 
SetTimeout (() => { 
cb(); 
BT000)3 


} 


Fm 


只 要 给 定义 测试 逻辑 的 函数 添加 一 个 参数 ， 就 可 以 把 Mocha 测试 用 例 定义 为 异步 的 。 这 个 
参数 通常 被 命名 为 sone。 下 面 的 代码 中 演示 了 如 何 给 异步 方法 . save () 写 测试 代码 。 


代码 清单 9-12 ”测试 异步 逻辑 


descripbe('asyncronous .save(doc)', () => { 
it('should save the document', (done) => { 
const pet = { name: 'Tobi' }; i 
memdb.save(pet, () => { 保存 文档 
用 第 一 个 const ret = memdb.first({ name: 'Tobi' }); 
文档 调用 assert (ret == pet) 断言 文档 正 
回调 0 告诉 Mocha 这 个 确保 存 了 
测试 用 例 做 完了 


}); 
}); 
这 个 规则 适用 于 所 有 挂钩 。 比 如 给 beforeEacn () 挂钩 加 一 个 清理 数据 库 的 回调 ，Mocha 
可 以 等 它 调 用 后 再 继续 。 如 果 调 用 aone () 时 它 的 第 一 个 参数 是 个 错误 , Mocha 会 报告 这 个 错误 ， 
并 将 这 个 挂 钧 或 测试 用 例 标 记 为 失败 : 
beforeEach( (done) => { 


memdb.clear (done); 


发 
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要 了 解 与 Mocha 有 关 的 更 多 内 容 ， 请 参见 其 完整 的 在 线 文档 。Mocha 也 可 以 测试 客户 端 


JavaScript。 


Mocha 的 非 并 行 测试 
Mocha 的 测试 不 是 并 行 执行 的 ， 而 是 一 个 接 一 个 地 执行 。 虽 然 这 样 执 行 的 慢 ， 但 写 起 来 更 
容易 。 不 过 Mocha 不 会 让 测试 运行 太 长 时 间 ， 一 个 测试 默认 不 超过 2000 毫秒 ， 超 过 这 个 时 长 
就 会 被 当 作 失败 的 测试 。 如 果 有 运行 时 间 更 长 的 测试 ， 可 以 用 --timeout 指定 一 个 更 大 的 数值 。 
对 于 大 多 数 测试 而 言 ， 串 行 运行 就 很 好 。 如 有 果 你 觉得 这 种 方式 有 问题 ， 还 有 其 他 可 以 并 行 
执行 测试 的 框架 ， 比 如 Vows， 我 们 把 它 放 在 下 一 节 讨 论 。 


9.1.3 Vows 


跟 很 多 单元 测试 框架 比 , 在 Vows 下 写 的 测试 代码 结构 化 更 强 , Vows 想 让 测试 更 容易 理解 和 
维护 。 

Vows 用 它 自己 的 BDD 术语 定义 测试 结构 。 按 Vows 的 定义 ， 一 个 测试 套件 中 包含 一 或 多 个 
批 次 。 你 可 以 把 批 次 当 作 一 组 相互 关联 的 情境 , 或 者 要 测试 的 概念 领域 。 批 次 和 上 下 文 是 并 行 运 
行 的 。 上 下 文中 可 能 包含 主题 、 一 或 多 个 拆 约 ， 以 及 /或 者 一 或 多 个 相关 联 的 情境 ( 内 部 情境 也 
是 并 行 运行 的 )。 主 题 是 跟 情 境 相 关 的 测试 逻辑 。 誓 约 是 对 主题 结果 的 测试 。Vows 对 测试 的 结构 
化 设 定 如 图 9-4 所 示 。 
























































一 或 多 个 批 次 





可 能 包含 可 能 包含 可 能 包含 


主题 一 或 多 个 壮 约 一 或 多 个 情境 
图 9-4 Vows 可 以 用 批 次 、 人 情境 、 主 题 和 誓约 把 测试 组 织 在 一 个 套件 内 


Vows 跟 Mocha 一 样 ， 是 专门 用 来 做 自动 化 程序 测试 的 。 它 们 的 差别 主要 体现 在 风格 和 并 行 性 
上 ，Vows 测 试 有 特定 的 结构 和 术语 。 本 节 会 给 出 一 个 例子 ， 介 绍 如 何 用 Vows 同时 运行 多 个 测试 。 
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执行 下 面 的 命令 ， 用 npm 安装 Vows 并 添加 到 to-do 项 目 中 : 


mkdir -p vows-todo/test 

Cd vows-todo 

touch todo.js 

touch test/todo-test.js 

npm init -y 

npm install --save-dev -g vows 








还 要 把 它 加 到 package.json 的 test 属性 上 ， 以 便 用 npm test 运行 测试 : 
"EOPLSES Dy. 
"tesSt™, "VOwS Cest/* js” 


j 


用 Vows 测试 程序 逻辑 


在 Vows 中 ， 既 可 以 运行 包含 测试 逻辑 的 脚本 来 触发 测试 ， 也 可 以 用 vows 命令 行 测 试 运行 




















顺 。 下 面 这 个 例子 是 个 独立 的 测试 脚本 (可 以 像 其 他 Node 脚本 那样 运行 ), 用 了 待 办 事项 程 


心 逻辑 测试 中 的 一 个 。 





序 核 





代码 清单 9-13 创建 了 一 个 批 次 。 在 这 个 批 次 内 定义 了 一 个 情境 。 在 情境 内 定义 了 一 个 主题 




















和 一 个 誓约 。 注意 它 在 主题 中 如 何 使 用 回调 处 理 异步 逻辑 。 如 果 主 题 不 是 异步 的 ， 
值 ， 不 用 通过 回调 。 将 文件 保存 为 test/todo-test.js。 








用 Vows 测试 待 办 事项 程序 


require('vows'); 


代码 清单 9-13 


Const vows = 


const assert = require('assert'); 
const Todo = require('./../todo'); 
vows.describe('Todo') .addBatch({ < 一 一 一 批 次 


'when adding an item': { 
toBLe. () Ss 
const todo = new Todo(); 
todo.add('Feed my cat'); 
return todo; 
ey 
'it should exist in my todos': 
assert.equal (todo.length, 1);} 
} 
} 


}) .export (module); 


现在 应 该 可 以 用 npm test 运 和 行 
全 局 环境 中 ， 也 可 以 用 下 面 这 条 命令 


过 未 0 
$ vows test/* 


要 了 解 与 Vows 有 关 的 更 多 内 容 ， 


(er, 











和 行 test 目录 下 的 所 有 测试 : 


请 查阅 该 项 目的 在 线 文档 ， 如 图 9-5 所 示 。 


可 以 直接 返回 





个 测试 了 。 如 果 你 用 npm i -g vows 把 Vows 安装 在 了 





oO (Mvowse«AsynchronousBDr x LAlex | 
€ © [DD vowsjs.org 人 女 @ = 
2 一 





















Vows 


Asynchronous behaviour 
driven development for Node. 


A topie not enttting on error 
/sh p othe 
A topic emitting an error 
There are two reasons why we might want 3 Vs aise an ex 
asynchronous testing. The first, and obvious reason is 3 A context with a nested context 
that node.js is asynchronous, and therefore our tests / c he environ 
should be. The second reason is to make tests which 
target I/O run much faster, by running them 
concurrently. 


A nested context 
V 
A ne 
V 


inro guide instaling reference about source 图 


图 9-5 Vows 用 宏和 流程 控制 实现 了 全 功能 的 BDD 测试 


Vows 提供 了 完备 的 测试 方案 ,但 仍然 可 以 用 别 的 断言 库 将 不 同 测试 库 的 功能 混合 搭配 到 一 
起 。 可 能 你 喜欢 Mocha,， 但 不 喜欢 assertion 模块 。 下 一 节 会 介绍 Chai， 它 可 以 代替 assert 模块 。 




















9.1.4 Chai 


Chai 是 个 流行 的 断言 库 ， 有 三 个 接口 : should、expect 和 assert。 下 面 的 代码 中 用 到 了 
assert, 其 看 起 来 就 像 Node 自 带 的 assertion 模块 , 但 它 还 有 用 来 比较 对 象 、 数 组 和 它们 的 属 
的 工具 。 比 如 用 typeof 比较 类 型 ， 用 property 检查 某 个 对 象 是 否 有 我 们 想 要 的 属 


代码 清单 9-14 ” Chai 的 assert 接口 























邓 | 


ERY 





const chai = require('chai'); 

const assert = chai.assert; 选择 断言 
CoOnst. GOG =: "Dar'; 接口 
const tea = { flavors: ['chai', 'earl grey', 'pg tips'] }; 


assert.typeOf (foo, 'string'); 





assert .equal (foo, 'bar'); 
assert.lengthOof (foo, 3); 


assert.property (tea, 'flavors'); 
assert.lengthOof (tea.flavors, 3); 


should 和 expect 接口 是 人 们 想 要 尝试 Chai 的 主要 原因 。 它们 提供 了 更 像 BDD 风格 的 API。 
下 面 是 expect 接口 的 例子 : 


const chai = require('chai'); 
const expect = chai.expect; 
const foo = 'bar'; 

expect (foo) .to.be.a('string'); 


ee to.equal ('bar'); 
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这 个 API 看 起 来 更 像 甘 语句 子 一 一 声明 式 风 格 更 元 长 ,但 看 起 来 更 通顺 。shoulg 换 了 种 风 
格 : 给 对 象 添 加 属性 ， 这 样 就 不 用 把 断言 放 在 expect 调用 里 了 。 


const chai = require('chai'); 
chai.should(); 
const foo = 'bar'; 


foo.should.be.a('string'); 
foo.should.equal ('bar'); 


要 用 哪个 接口 取决 于 项 目 。 如 果 先 写 测试 , 并 将 其 当 作 项 目的 文档 , 详细 的 expect 和 shoula 
接口 很 好 用 。 因 为 不 改变 原型 ，JavaScript 纯粹 主义 者 更 喜欢 expect ， 但 那些 习惯 了 Ruby 的 人 
可 能 更 熟悉 shoula 那样 的 API。 

Chai 有 很 多 插件 , 包括 一 些 趁 手 的 工具 , 比如 可 以 用 promise 写 测试 代码 的 chai-as-promised， 
以 及 根据 统计 方法 比较 数值 的 chai-stats。 注 意 ， 因 为 Chai 是 断言 库 ， 所 以 要 跟 Mocha 这 样 的 测 
试 运行 者 配合 使 用 。 

另 一 个 像 Chai 一样 的 BDD 断言 库 是 Should.js。 下 一 节 会 介绍 如 何 用 Shouldjjs 写 测 试 。 








9.1.5 Should.js 


Should.js 是 个 断言 库 ， 它 用 类 似 于 BDD 的 风格 表示 断言 ， 让 测试 更 容易 看 懂 。 它 的 设计 初 
应 是 搭配 其 他 测试 框架 一 起 用 , 所 以 你 可 以 继续 用 自己 喜欢 的 框架 。 本 市 会 介绍 如 何 用 Should.js 
写 断 言 ， 我 们 用 的 例子 是 编写 代码 测试 一 个 定制 的 模块 。 

Shouldjs 跟 其 他 框架 的 搭配 很 容易 ， 因 为 它 只 是 给 object .prototype 增加 了 一 个 shoula 
属性 。 这 样 你 就 可 以 写 出 表达 能 力 更 强 的 断言 ， 比 如 user .role.should.equal ('admin')， 
或 者 users.should.include ('rick')。 

比如 说 ， 你 要 编写 一 个 Node 命令 行 的 小 费 计算 器 ， 在 你 跟 朋友 们 采用 AA 制 付 费时 ， 要 用 
它 计算 每 个 人 该 付 多 少 钱 。 你 和 希望 非 程序 员 朋 友 也 能 看 懂 测 试 计算 逻 辑 的 代码 ,以免 他 们 怀疑 你 
要 诈 。 

输入 下 面 的 命令 设置 这 个 小 费 计 算 器 项 目 ， 它 会 创建 一 个 文件 夹 ， 还 会 创建 测试 用 的 tips.js 
文件 : 

mkdir -p tips/test 

cd tips 


touch index.js 
touch test/tips.js 


然后 运行 下 面 的 命令 安装 Should.js: 



























































npm init -y 
npm install --save-dev should 
接 下 来 编辑 index.js， 放 入 实现 程序 核心 功能 的 代码 。 具 体 来 说 ， 小 费 计 算 器 包含 四 个 辅助 
函数 : 
口 addPercentageToEach 


























按 给 定 的 百分比 加 大 数组 中 的 所 有 数值 ; 








9.1 单元 测试 215 





口 sum 一 一 计算 数组 中 所 有 数值 的 和 ; 

将 要 显示 的 值 变 成 百分比 格式 ; 
口 dollarFormat 将 要 显示 的 值 变 成 美元 格式 。 

下 面 是 实现 这 些 逻 辑 的 代码 ， 把 它们 放 到 index.js 中 。 


代码 清单 9-15 “分账 时 计算 小 费 的 逻辑 








口 percentFormat 














ORG erentags Topach = (prices, percentage) => { < 一 一 按 百分比 加 大 数组 
return prices.map((total) => { 元 素 中 的 数值 
total = parseFloat (total); 
return total + (total * percentage); 
ee 
}; 计算 数组 中 所 
exports.sum = (prices) => { 了 有 数值 的 和 
return prices.redquce( (currentSum，CcurrentValue) => { 


+ parseFloat (currentValue); 


将 要 显示 的 值 变 
< 成 百分比 格式 


return parseFloat (currentSum) 
} 
jj 
exports.percentFormat = 
return parseFloat (percentage) 
地 
exports.dollarFormat = (number) => { 
return ‘$${parseFloat (number) .toFixed(2 
上 


现在 把 代码 清单 9-16 中 的 代码 放 到 test/tips.js 中 。 这 段 代 码 加 载 了 小 费 逻 辑 模块 ; 定义 了 
税率 、 小 费 百 分 比 ， 以 及 账单 中 的 收费 条 目 ; 测试 了 每 个 数组 元 素 的 百分比 增加 额 ; 测试 了 账 
单 总 额 。 


(percentage) => { 
* 100 + 


EY 
中 " 学 


了 |] 将 要 显示 的 值 变 


人 美元 格式 





代码 清单 9-16 


分 账 时 测试 计算 小 费 的 逻辑 








const tips = require('..'); 一 一 一 使 用 小 费 逻 辑 模块 

const should = require('should'); 

const tax = 0.12; 一 一 一 定义 税率 和 小 费 比 率 

GONnet ti 0%L5 

const prices = [10, 20]; | 一 一 一 定义 要 测试 的 账单 项 

const pricesWithTipAndTax = tips.addPercentageToEach (prices, tip + tax); 
pricesWithTipAndTax[0] .should.equal (12.7); 起 一 一 
pricesWithTipAndTax[1] .should.equal (25.4); : 定义 税 和 小 费 的 增加 额 


tips.sum(pricesWithTipAndTax) .toFixed (2); 
< 一 一 一 测试 账单 总 额 


const totalAmount = 
totalAmount.should.equal ('38.10°'); 


const totalAmountAsCurrency = tips.dollarFormat (totalAmount); 
totalAmountAsCurrency.should.equal('$38.10'); 


const tipAsPercent = tips.percentFormat (tip); 
tipAsPercent.should.equal ('15%'); 


用 下 面 的 命令 运行 这 个 脚本 。 如 果 一 切 正常 ,脚本 应 该 不 会 输出 什么 ， 因 为 断言 没有 抛 出 错 
误 。 你 的 朋友 更 加 信任 你 了 。 
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$ node test/tips.js 
如 果 想 让 运行 命令 更 简单 些 ， 可 以 把 它 加 到 package.json 的 scripts 里 面 : 


"ECrELOESY, “{ 
"test": "node test/tips.js" 
} 


Should.js 支持 很 多 种 断言 ， 从 使 用 正则 表达 式 的 到 检查 对 象 属性 的 全 都 有 ， 其 可 以 对 程序 生 
成 的 数据 和 对 象 进行 全 面 检查 。 这 个 项 目的 GitHub 页 面 上 有 完整 的 Should.js 功能 文档 。 
除了 断言 库 , 测试 时 还 经 常 要 用 到 探测 器 、 存 根 和 模拟 对 象 。 下 一 节 介 绍 如 何 用 Sinon.JS 做 


这 些 事情 。 











9.1.6 ”Sinon.JS 的 探测 器 和 存根 


模拟 对 象 和 存根 库 是 测试 工具 箱 里 的 终极 工具 。 我 们 写 单元 测试 是 为 了 把 系统 的 各 个 组 成 部 
分 隔离 开 单 独 测试 , 但 有 时 候 这 很 难 做 到 。 比 如 测试 图 片 缩放 的 代码 时 ， 如 果 不 想 读 写 真正 的 图 
片 文 件 , 该 怎么 写 测试 代码 呢 ? 代码 中 不 应 该 有 避 开 文件 系统 读 写 的 特殊 测试 分 支 ,因为 那样 就 
不 是 真正 的 测试 了 。 在 这 种 情况 下 ， 需 要 创建 文件 系统 功能 的 存根 。 我 们 可 以 用 存根 代替 尚未 准 
备 好 的 依赖 项 ， 这 有 助 于 实现 真正 的 TDD。 

本 节 会 介绍 如 何 用 Sinon.JS 编写 测试 探测 器 、 存 根 和 模拟 对 象 。 不 过 我 们 要 先 创建 个 新 项 目 ， 
然后 安装 Sinon : 




































































mkdir sinon-js-examples 
cd sinon-js-examples 
npm init -y 

mkdir test 

npm i --save-dev sinon 


接着 创建 要 测试 的 样 例文 件 。 这 个 例子 里 用 了 一 个 简单 的 JSON 键 / 值 数 据 库 。 我 们 要 创建 一 
个 文件 系统 API 的 存根 , 这 样 就 不 用 在 文件 系统 里 创建 真正 的 文件 了 。 我 们 也 可 以 像 下 面 这 样 只 
测试 数据 库 代 码 ， 避 开 处 理 文件 的 代码 。 


代码 清单 9-17 数据 库 类 


const fs = require('fs'); 














class Database { 
constructor(filename) { 
this.filename = filename; 
this.data = {}; 
} 


save(cb) { 
fs.writeFile(this.filename, JSON.stringify (this.data), cb); 
} 


insert (key, value) { 
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this.data[lkey] = value; 
} 
} 


module.exports = Database; 


将 上 面 的 代码 存 为 dbjs， 做 好 用 Sinon 探测 器 测试 它 的 准备 。 

1. 探测 器 

有 时 候 我 们 只 是 想 看 看 某 个 方法 是 否 被 调用 了 。 探测 器 最 适合 做 这 个 。 借 助 它 的 API， 可 以 将 
某 个 方法 替换 成 能 够 进行 断言 的 东西 。 比 如 用 Sinon 的 方法 蔡 身 spy 模拟 i 中 的 fs .writeFile: 


sinon.spy (fs, 'writerFile'); 

测试 完成 后 ， 可 以 用 fs .writeFile.restore() ;复原 原来 的 方法 。 

在 Mocha 之 类 的 测试 库 中 使 用 时 , 应 该 把 这 些 操作 放 在 beforeEach 和 afterEach 中 。 下 
面 是 探测 器 用 法 的 完整 示例 。 将 这 段 代 码 存 为 spies.js。 


代码 清单 9-18 ”使 用 探测 器 
const sinon = require('sinon'); 
const Database = require('./db'); 
const fs = require('fs'); 
const database = new Database('./sample.json'); 





















































9* 替换 fs 
const fsWriteFileSpy = sinon.spy (fs, 'writeFile'); 方法 
const saveDone = sinon.spy(); 


database.insert('name', 'Charles Dickens'); 
database.save (saveDone); 断言 iteFil 
站 Writerile 
口 1 后 Ns 
sinon.assert.calledOnce (fsWriterFileSpy); 是 只 调用 了 一 次 
9 恢复 原来 
fs.writeFile.restore(); 的 方法 








设置 好 探测 器 后 鲍 运行 要 测试 的 代码 。 然后 调用 sinon .assert@@ 确 保 方法 被 调用 了 。 恢复 
原来 的 方法 四。 这 项 测试 中 的 恢复 操作 不 是 必须 的 ， 但 恢复 之 前 改变 的 方法 是 最 佳 实践 。 

2. 存根 

有 时 需要 控制 代码 流程 。 比 如 在 测试 错误 处 理 代 码 时 ， 需 要 强迫 执行 错误 处 理 分 文 。 前 面 那 
个 例子 可 以 改写 一 下 ， 用 存根 取代 探测 器 ， 以 便 执 行 writeFile 的 回调 函数 。 注 意 ， 我 们 并 不 
想 调 用 真正 的 writeFile， 只 是 希望 能 运行 那个 回调 函数 。 下 面 是 如 何 使 用 存根 蔡 换 函数 的 例 
子 ， 将 它 存 为 stub.js。 


代码 清单 9-19 ”使 用 存根 


const sinon = require('sinon'); 

const Database = require('./db'); 

const fs = require('fs'); 

const database = new Database('./sample.json'); 
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const stub = sinon.stubl(fs, 'writeFile', (file, data, cb) => { | 
eb():; 

}); 用 自己 的 函数 代替 

const saveDone = sinon.spy(); writeFile 

database.insert('name', 'Charles Dickens'); 


database.save (saveDone); 二 
断言 writeFile 
sinon.assert.calledOnce (stub); < 一 被 调用 了 


sinon.assert.calledOnce (saveDone); en 
断言 database.save 
的 回调 运行 了 


fs.writeFrile.restore(); 


在 测试 有 大 量 用 户 提供 的 函数 、 回 调和 promise 的 代码 时 ， 把 存根 和 探测 器 结合 起 来 用 是 最 














理想 的 办 法 。 看 过 这 些 单元 测试 工具 后 ， 我 们 该 去 探究 男 一 种 风格 的 测试 了 : 功 外 
9.2 功能 测 试 





测试 。 


在 大 多 数 Web 项 目的 开发 中 ， 进 行 功能 测试 的 办 法 都 是 按 用 户 指定 的 需求 列表 驱动 浏览 
执行 操作 ， 然 后 检查 各 种 DOM 变化 。 比 如 在 做 一 个 内 容 管理 系统 时 ， 要 对 图 片 库 的 上 传 功 能 做 
功能 测试 , 也 就 是 上 传 一 张 图 片 ， 然 后 检查 是 不 是 添加 上 了 ,再 检查 是 不 是 加 到 了 正确 的 图 片 列 



























































表 中 。 
Node 中 做 功能 测试 的 工具 很 多 ， 选 起 来 会 让 人 有 种 乱 花 渐 欲 迷人 有 眼 的 感觉 。 





和 





不 过 它们 大 体 


上 可 以 分 成 两 类 : 无 头 测试 和 基于 浏览 器 的 测试 。 无 头 测 试 基本 上 都 是 用 PhantomJS 之 类 的 工具 
提供 一 个 可 以 在 终端 里 使 用 的 浏览 器 环境 ， 也 有 轻便 一 些 的 方案 会 用 Cheerio 和 JSDOM 这 样 的 
库 。 基 于 浏览 器 的 测试 用 Selenium 之 类 的 浏览 器 自动 化 工具 ， 通 过 脚本 驱动 真正 的 浏览 器 。 两 






































种 测试 方式 用 的 底层 测试 工具 都 是 一 样 的 ， 你 可 以 根据 自己 的 偏好 用 Mocha、 








Cucumber 驱动 Selenium 测试 自己 的 程序 。 图 9-6 给 出 了 一 个 测试 环境 的 例子 。 


*。Mocha 
、 。 Chai 
测试 脚本 | .DOM 断 言 工具 





*Selenium 
浏览 器 层 | “ Firefox 








。 在 NODE_ENV=test 环 境 下 运行 的 程序 
你 的 程序 | “测试 数据 库 





























图 9-6 用 浏览 器 自动 化 进行 测试 
本 市 会 介绍 功能 测试 方案 ， 让 你 可 以 根据 自己 的 需求 搭建 测试 环境 。 











Jasmine 甚至 
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Selenium 


Selenium 是 基于 Java 的 浏览 器 自动 化 库 ， 它 很 受 欢 迎 。 在 特定 语言 驱动 器 的 帮助 下 ， 我 们 
可 以 连接 到 Selenium 服务 器 上 ， 用 真正 的 浏览 器 跑 测 试用 例 。 本 节 会 介绍 如 何 使 用 Node 的 
Selenium 驱动 器 WebdriverIO 。 

Selenium 用 起 来 比 使 用 纯粹 的 Node 测试 库 困 难 一 些 ， 需 要 安装 Java， 还 要 下 载 ee JAR 
文件 。 下 载 与 你 的 操作 系统 对 应 的 Java， 再 到 Selenium 网 站 上 下 载 它 的 JAR 文件 。 然 后 运行 下 
面 的 命令 启动 一 个 Selenium 服务 器 


java -jar selenium-server-standalone-2.53.0.jar 


你 得 到 的 Selenium 版 本 可 能 不 一 样 。 另 外 还 要 提供 浏览 器 可 执行 文件 所 在 的 路 径 。 比 如 在 
browserName 被 设 为 Firefox 的 Windows 10 中 ， 可 以 像 下 面 这 样 指定 Firefox 的 完整 路 径 : 


Java -jar -Dwebdriver.firefox.driver="C:\path\to\firefox.exe" selenium- 
server-standalone-3.0.1.jar 


确切 的 路 径 要 看 Firefox 是 怎么 安装 的 。SeleniumHQ 的 文档 里 有 Firefox 驱动 的 详细 介绍 。 
Chrome 和 Microsoft Edge 配置 跟 Firefox 差不多 。 
现在 创建 新 的 Node 项目， 安装 WebdriverIO: 














mkdir -p selenium/test/specs 

cd selenium 

npm init -y 

npm install --save-dev webdriverio 
npm install --save express 


WebdriverIO 很 贴心 地 提供 了 一 个 配置 文件 生成 器 。 可 以 用 waio config 运行 它 : 


./node modules/.bin/wdio config 


接受 所 有 问题 和 提供 的 默认 值 。 图 9-7 是 我 的 截屏 。 





? Where do you want to execute your tests? On my local machine 

? Which framework do you want to use? mocha 

? Shall I install the framework adapter for you? Yes 

? Where are your test specs located? ./test/specs/**/*,]js 

? Which reporter do you want to use? 

? Do you want to add a service to your test setup? 

? Level of logging verbosity: verbose 

? In which directory should screenshots gets saved if a command fails? ./errorShots/ 
? What is the base url? http://localhost:4000 


Installing wdio packages: 
pkg: wdio-mocha-framework 


Packages installed successfully, creating configuration file,.. 


Configuration file was created successfully! 
To run your tests, execute: 


$ wdio wdio.conf.js 





图 9-7 用 wdio 配置 Selenium 测试 
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把 waio 命令 加 到 package.json 里 ， 以 便 以 后 可 以 用 npm test 运行 测试 : 


oordDtet 二 
"test": "wdio wdio.conf.js" 
} > 


该 添加 测试 对 象 了 ， 一 个 简单 的 Express 服务 器 就 好 。 下 面 这 段 代 码 就 是 我 们 后 面 要 测试 的 
对 象 。 将 它 存 为 ndex.js ( 随 书 源码 见 ch09-testing/selenium/index.js )。 


代码 清单 9-20 Express 项目 样本 
const express = require('express'); 
const app = express(); 
Const port = process.env.PORT || 4000;，; 

















app.get('/', (req, res) => { 
res.send(. 
<html> 
<head> 
<title>My to-do list</title> 
</head> 
<body> 
<h1>Welcome to my awesome to-do list</hi1> 
</body> 
</html> 
这 


app.listen(port, () => { 
console.log('Running on port', port); 
和 党 


WebdriverIO 的 API 简单 流畅 、 语 法 清晰 、 易 于 学 习 掌 握 其 至 支持 用 CSS 选择 器 写 测试 
代码 。 下 面 这 段 代 码 ( 随 书 源码 见 test/specs/todo-test.js ) 演示 了 如 何 设置 WebdriverIO 客户 端 ， 
然后 用 它 检 查 页 面 的 标题 。 


代码 清单 9-21 ”WebdriverIO 测试 

















const assert = require('assert'); 
const webdriverio = require('webdriverio');} 
describe('todo tests', () => { 
let client; 
before(() => { 设置 WebdriverlO 
client = webdriverio.remote(); 客户 端 


return client.init(); 
于 小池 
守候 人 GO List, test"s () =>:t{ 


return client .9 获取 首页 
-Ur (A 
从 消息 头 中 .getTitle() 
获取 title .then(title => assert.equal (title, 'My to-do list')); < 
> 断言 title 
}); 是 期 望 值 
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WebdriverIO 连 好 之 后 @Q@， 可 以 用 它 的 客户 端 实例 获取 程序 页 面 @。 然 后 查询 浏览 器 中 文档 
的 当前 状态 一 一 上 面 这 个 例子 是 用 getTitle 获取 文档 头 部 的 title 元 素 。 如 果 想 用 CSS 类 获 
取 文 档 元 素 ， 可 以 用 .elements。 各 种 操作 文档 、 表 单 ， 其 至 cookie 的 方法 应 有 尽 有 。 

虽然 这 个 测试 看 起 来 跟 Mocha 测试 差不多 ， 但 它 可 以 用 真正 的 浏览 器 测试 web 程序 。 在 端 
口 4000 上 启动 服务 器 : 

PORT=4000 node index.js 

然后 运行 npm test ， 你 应 该 会 看 到 Firefox， 以 及 在 命令 行 里 运行 的 测试 。 如 果 想 换 成 
Chrome， 可 以 修改 wdio.confjs 里 的 prowserName。 


























用 Selenium 完成 更 高 级 的 测试 
在 用 WebdriverIO 和 Selenium 测试 比较 复杂 的 程序 时 ， 比 如 那些 用 到 了 React 或 Angular 
的 ， 可 能 需要 测试 一 些 辅助 性 方法 。 有 些 方 法 要 等 到 特定 元 素 出 现 才 会 继续 执行 ， 要 异步 泻 染 
文档 的 React 程序 就 是 这 样 的 ， 它 会 在 远程 数据 陆续 到 达 时 多 次 更 新 文档 。 
看 看 waitFor* 方 法 ， 比 如 waitForVisible， 了 解 更 多 信息 。 


9.3 处理 失败 的 测试 


在 做 已 经 成 形 的 项 目 时 ， 总 会 碰 到 测试 失败 的 时 候 。Node 提供 了 一 些 工 具 ， 可 以 获取 更 详 
细 的 失败 信息 ， 本 节 会 介绍 调试 失败 的 测试 时 如 何 让 测试 用 例 输出 更 多 信息 。 

测试 失败 时 , 我 们 要 做 的 第 一 件 事 就 是 生成 更 详细 的 日 志 。 接 下 来 会 演示 如 何 用 NODE_DEBUG 
完成 这 项 任务 。 
9.3.1 获取 更 详细 的 日 志 

测试 失败 后 ， 需 要 知道 程序 当时 在 做 些 什么 。 在 Node 中 有 两 种 途径 : 一 种 是 用 于 Node 内 
部 的 ， 另 一 种 是 给 npm 模块 用 的 。 我 们 用 NODE_DEBUG 调试 Node 的 核心 模块 。 

1. 使 用 NODE_DEBUG 

假设 你 忘 了 给 一 个 能 套 很 深 的 文件 系统 调用 提供 回调 函数 ,就 像 下 面 这 段 代 码 一 样 ， 
抛 出 一 个 异常 : 


const fs = require('fs'); 















































局 





Tr 





它 就 会 





function deeplyNested() { 
fs.readFile('/'); 

} 

deeplyNested (); 


关于 这 个 异常 ， 栈 跟踪 输出 的 信息 很 有 限 ， 特 别 是 根本 就 没 提供 异常 源 自 何 处 的 完整 信息 : 
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fe je:60 
throw err; // Forgot a callback but don't know where? Use 
NODE_DEBUG=fs 


入 


Error: EISDIR: illegal operation on a directory, read 
at Error (native) 


没什么 有 价值 的 信息 ， 很 多 程序 员 看 到 这 个 都 会 抱怨 Node。 但 就 像 注释 中 指出 的 那样 ， 可 
以 用 NODE_DEBUG=fs 获取 更 多 信息 。 现 在 像 下 面 这 样 运行 这 个 脚本 : 

NODE_DEBUG=fs node node-debug-example.js 

可 以 看 到 对 调试 更 有 帮助 的 详细 跟踪 信息 : 

Few eS 


throw backtrace; 


人 入 





加 
局 








Error: EISDIR: illegal operation on a directory, read 
rethrow (fs.js:48:21) 

maybeCallback (fs.js:66:42) 

Object.fs.readFile (fs.js:227:18) 

deeplyNested (node-debug-example.js:4:6) 
Object.<anonymous> (node-debug-example.js:7:1) 
Module._compile (module.js:435:26) 

Object .Module._extensions..js (module.js:442:10) 
Module.load (module.js:356:32) 
Function.Module._load (module.js:311:12) 
Function.Module.runMain (module.js:467:10) 


ogo 99 yy 





oy 


这 里 明确 指出 问题 出 在 我 们 的 文件 里 , 异常 源 自 第 7 行 调用 那个 函数 里 的 第 4 行 代码 。 有 了 
这 样 的 信息 ， 调 试 使 用 Node 核心 模块 的 代码 就 变 得 容易 多 了 ， 不 仅 是 文件 系统 ， 还 有 HTTP 客 
户 端 和 服务 需 模块 之 类 的 网 络 库 。 

2. 使 用 DEBUG 
DEBUG 是 NODE_DEBUG 之 外 的 另 一 个 公共 选项 ，npm 上 的 很 多 包 都 会 看 这 个 环境 变量 。DEBUG 
的 参数 风格 跟 NODE_DEBUG 一 样 ， 也 就 是 说 可 以 指定 要 调试 的 模块 列表 ， 或 者 用 DEBUG='*' 查 
看 所 有 模块 的 调试 信息 。 图 9-8 是 DBUc= '* ' 时 运行 第 4 章 那 个 项 目的 截屏 。 


» tldr git:(master) X DEBUG="*" npm start 
































Ly 














> tldr@1.0.0 start /Users/alex/Documents/Code/nodeinaction/ch04-what-is-a-node-web-app/tldr 
> node index.js 


express:application set "x-powered-by" to true +0ms 
express:application set "etag" to 'weak' +3ms 
express:application set "e fn" to [Function: wetag] +2ms 
express:application set "env" to 'development' +1ms 


express:application set "query parser" to ‘extended' +Oms 
express:application set "query parser fn" to [Function: parseExtendedQueryString] +0ms 


express:application set "subdomain offset" to 2 +0ms 

express:application set "trust proxy" to false +Oms 

express:application set "trust proxy fn" to [Function; trustNone] +1ms 

express:application booting in development mode +0ms 

express:application set "view" to [Function: View] +Oms 

express;application set "views" to '/Users/alex/Documents/Code/nodeinaction/ch04-what-is-a-node-web-app/tldr/views' +Oms 
express:application set "jsonp callback name" to 'callback' +0ms 

express:router use / query +429ms 





图 9-8 ”DEBUG='*' 时 运行 的 Express 程序 
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如 果 想 在 自己 的 项 目 中 支持 NODE_DEBUG， 可 以 用 util.aqebuglog 方法 : 


const debuglog = redquirel('util').dqebuglog('example'): 
debuglog('You can only see these messages by setting NODE_ DEBUG=example!'); 


要 做 用 DEBUG 配置 的 调试 记录 器 ， 需 要 debug 包 。 调 试 记 录 器 的 数量 没有 限制 ， 可 以 根据 
自己 的 需要 创建 。 假 设 你 正在 做 一 个 MVC Web 程序 ， 可 以 为 模型 、 视 图 和 控制 器 分 别 创建 一 个 
调试 记录 器 。 这 样 在 测试 失败 后 ,你 可 以 指定 使 用 哪个 记录 器 ,去掉 无 关 信 息 ， 只 保留 必要 的 信 
息 以 便 调试 。 下 面 是 使 用 debug 模块 的 例子 ( 随 书 源码 见 ch09-testing/debug-example/index.js )。 














代码 清单 9-22 使 用 debug 包 
const debugViews = require('debug') ('debug-example:views'); 
const debugModels = require('debug') ('debug-example:models'); 


debugViews ('Example view message'); 
debugModels('Example model message'); 


如 果 只 想 看 视图 日 志 ， 将 DEBUG 设 为 depug-example:views: 











DEBUG=debug-example:views node index.js 


~ 


debug 模块 还 有 一 个 功能 ， 我 们 可 以 在 记录 器 名 称 前 加 个 连 字符 号 关闭 它 : 
DEBUG='* -debug-example:views' node index.js 


也 就 是 说 可 以 在 使 用 * 的 同时 关闭 某 些 日 志 带 ,从 而 从 输出 中 去 掉 不 需要 的 ,或 者 说 噪音 部 分 。 


9.3.2 更 好 的 栈 跟踪 


如 果 代 码 中 有 异步 操作 ,或 者 包含 了 使 用 异步 回调 或 promise 的 任何 东西 ， 那 么 栈 跟踪 信息 
不 够 详细 时 就 很 难 办 。npm 上 有 人 能 解决 这 些 问题 的 包 。 比 如 说 ， 在 回调 异步 运行 时 ，Node 不 会 
在 操作 排 上 队列 后 保留 调用 栈 。 我 们 来 做 个 实验 验证 一 下 。 先 创建 两 个 文件 ， 一 个 是 asyncjs， 在 
其 中 定义 一 个 异步 函数 ; 另 一 个 是 indexjs， 只 是 引入 async,js 就 好 。 下 面 是 ayncjs 的 代码 ( 随 
书 源码 见 ch09-testing/debug-stacktraces/async.js ): 















































module.exports = () => { 
setTimeout (() => { 
throw new Error(); 
} 
}; 


这 是 index.js， 只 需要 引入 async.js: 

require('./async.js') (); 

用 node ingex.js 运行 indexjs， 你 会 看 到 一 段 只 显示 了 抛 出 异常 的 位 置 ， 没 有 调用 者 的 
栈 跟踪 信息 : 


throw new Error(); 


入 
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Error 
at null._onTimeout (async.js:3:11) 
at Timer.listOnTimeout (timers.js:92:15) 


trace 包 可 以 改变 这 种 情况 ， 运 行 node -r trace index.js， 其 中 -r 的 意思 是 告诉 Node 
先 引 入 trace 模块 ， 然 后 再 加 载 其 他 东西 。 

有 时 候 我 们 会 觉得 栈 跟 踪 太 详细 了 ， 比 如 包含 太 多 Node 内 部 信息 时 ， 这 也 是 个 问题 。 这 时 
可 以 用 clarify 清理 栈 跟踪 信息 。 仍 然 是 带 着 -r 运行 : 




































































S node -r clarify index.js 
throw new Error(); 


入 


Error 
at null._onTimeout (async.js:3:11) 


如 果 想 把 栈 跟 踪 放 在 错误 报警 邮件 里 ， 那 就 更 需要 clarify 了 。 
如 果 运 行 的 是 浏览 器 里 的 代码 ， 可 能 是 一 个 同 构 的 Web 应 用 程序 中 的 一 部 分 ， 那 么 可 以 用 
Source-map-support 改善 栈 跟踪 信息 。 这 个 既 可 以 用 -r 指定 ， 也 可 以 放 在 测试 框架 中 : 




















$ node -r source-map-support/register index.js 
$ mocha --require source-map-support/register index.js 


下 次 再 因为 异步 代码 生成 的 栈 跟踪 而 信 感 挫折 时 ， 找 找 有 没有 trace 和 clarify 这 样 的 工具 ， 
以 确保 你 得 到 的 就 是 V8 和 Node 能 提供 的 最 好 结 





9.4 总 结 





口 编写 单元 测试 需要 Mocha 这 样 的 测试 运行 器 。 

口 Node 自 带 了 一 个 断言 库 assert。 

口 还 有 其 他 断言 库 ， 包 括 Chai 和 Should.js。 

口 如 果 不 想 运行 某 些 代码 ， 比 如 网 络 请 求 ， 可 以 用 Sinon.JS。 

口 Sinon.JS 也 可 以 探测 代码 ， 验 证 某 个 函数 或 方法 是 不 是 运行 了 。 

口 通过 利用 脚本 驱动 真正 的 浏览 器 ， 可 以 用 Selenium 编写 浏览 器 测试 。 























Node 程序 的 部 署 及 运 维 








本 章 内 容 

口 选择 在 哪里 安置 你 的 Node 程序 
口 典型 程序 的 部 署 

口 保证 在 线 时 间 及 性 能 最 大 化 

















Web 程序 的 开发 是 一 但 事 儿 ， 把 它 放 到 生产 环境 中 又 是 另 一 码 事 儿 。 每 种 Web 技术 都 有 各 
种 增强 稳定 性 和 提高 性 能 的 技巧 、 窍 门 ，Node 也 不 例外 。 本 章 不 仅 会 让 你 对 如 何 选择 合适 的 部 
署 环境 有 个 大 体 认识 ， 还 会 介绍 如 何 保证 程序 的 在 线 时 间 。 

后 面 的 章节 会 列 出 部 署 环境 的 主要 类 型 ， 还 有 保证 在 线 时 长 的 各 种 办 法 。 














10.1 安置 Node 程序 


本 书 中 开发 的 Web 程序 用 的 都 是 基于 Node 的 HTTP 服务 器 。 浏 览 器 不 需要 通过 Apache 或 
人 这 样 的 专用 HTTP 服务 器 跟 程序 通话 。 但 也 可 以 在 应 用 程序 之 前 放 一 个 Nginx 这 样 的 服务 

， 所 以 Node 程序 基本 上 可 以 放 在 之 前 你 放置 Web 服务 器 的 所 有 地 方 。 

云 提供 商 ， 包 括 Heroku 和 Amazon， 也 支持 Node。 因 此 有 三 种 可 靠 且 可 扩展 的 方式 运行 Node 
程序 : 




















口 平台 即 服 务 一 一 在 Amazon、Azure 或 Heroku 上 运行 ; 
口 服务 器 或 虚拟 主机 在 云 上 、 私 有 主机 公司 或 你 们 公司 内 部 的 服务 器 上 ，UNIX 或 
Windows 服务 器 都 可 以 ; 
口 容器 一 用 Docker 这 样 的 软件 容器 运行 你 的 程序 和 其 他 相关 服务 。 

这 三 种 方案 选择 起 来 很 难 , 因为 即便 只 是 想 先 试 一 下 也 并 不 是 特别 容易 。 每 种 方案 都 不 止 一 
个 选择 : 比如 说 ，Amazon 和 Azure 能 提供 所 有 这 些 部 署 策略 。 本 节 会 介绍 这 些 方 案 的 需求 以 及 
它们 的 优点 和 缺点 ,以便 让 你 知道 哪个 更 适合 你 的 程序 。 好 在 每 种 方案 都 有 免费 或 价格 合理 的 选 
项 ， 所 以 对 爱好 者 和 专业 人 士 来 说 ， 这 些 方 案 应 该 都 在 能 力 范围 之 内 。 
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10.1.1 平台 即 服务 


有 了 平台 即 服务 ( PaaS )， 程 序 部 署 的 准备 工作 基本 上 就 是 注册 个 账号 、 创 建新 程序 ， 然 后 
给 项 目 添 加 一 个 远程 Git 地 址 。 把 程序 推送 到 那个 地 址 就 部 署 好 了 。 默 认 情况 下 ， 程 序 会 被 放 在 
单个 容器 里 ( 各 家 厂商 对 容器 的 定义 不 太一 样 )， 并 且 如 果 程 序 前 溃 了 的 话 ， 服 务 会 尝试 重新 局 
动 它 。 你 只 能 通过 日 志 、Web 界面 和 命令 行 管 理 程序 。 一 般 通 过 运行 多 个 程序 实例 实现 扩展 ， 这 
也 就 意味 着 要 支付 更 多 费用 。 表 10-1 是 Paag 常见 特性 概览 。 


表 10-1 PaasS 的 特性 


























































































































用 性 高 
功能 Git 推送 部 署 ， 简 单 的 水 平 扩展 能 力 
基础 设施 抽象 的 / 黑 盒 子 

商业 适用 性 良好 : 应 用 程序 通常 被 网 络 隔离 
价格 * 氏 流 量 : $$; 受 欢 迎 的 网 站 : $$8$ 
厂商 Heroku, Azure, AWS Elastic Beanstalk 








a $: 便宜 ; $$$$$: 贵 


PaaS 提供 商 们 会 支持 他 们 喜欢 的 数据 库 和 第 三 方 数据 库 。 对 于 Heroku 来 说 ， 就 是 
PostgreSQL; 对 Azure 来 说 ， 就 是 SQL Database。 因 为 数据 库 连 接 的 配置 会 放 在 环境 变量 里 ， 所 
以 不 用 在 项 目 源 码 里 添加 数据 库 访 问 和 凭证 。PaagS 是 爱好 者 的 福音 ， 因 为 它 价 格 便宜 ， 对 于 流量 
不 高 的 小 项 目 来 说 ， 甚 至 可 能 是 免费 的 。 

有 些 提供 商 的 产品 用 起 来 更 容易 : 对 于 程序 员 来 说 ， 即 便 不 懂 系 统管 理 或 DevOps， 只 要 熟 
悉 Git， 就 会 觉得 Heroku 用 起 来 极其 容易 。 一 般 来 讲 ，PaagS 知道 如 何 运行 那些 用 Node、Rails 和 
Django 等 热门 工具 开发 的 项 目 ， 可 以 说 基本 上 都 是 即 插 即 用 的 。 

让 Node 在 Heroku 上 10 分 钟 上 线 的 例子 

接 下 来 我 们 要 在 Heroku 上 部 署 一 个 程序 。 按 照 Heroku 的 默认 配置 ， 这 个 程序 会 部 署 在 一 个 
轻便 的 Linux 容器 上 ， 即 Heroku 所 说 的 dyno 上 ， 来 为 你 的 程序 服务 。 在 Heroku 上 部 署 程序 的 
前 提 条 件 如 下 。 

口 一 个 等 待 部 署 的 程序 。 

口 Heroku 账号 : https://signup.heroku.com/。 

口 Heroku CLI: https:/devcenter.heroku.comyarticles/heroku-cli。 
这 些 都 准备 好 后 ， 在 命令 行 里 登录 Heroku: 

heroku login 


Heroku 会 提示 你 输入 邮箱 地 址 和 密码 。 接 下 来 ， 创 建 一 个 简单 的 Express 程序 : 


mkdir heroku-example 

npm i -g express-generator 
express 

npm i 
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运行 npm start， 访 问 http:/localhost:3000， 确 保 一 切 正常 。 接 着 初始 化 Git 库 ， 然 后 创建 
Heroku 程序 : 





gilt Ti 
git aqd . 
git commit -m 'Initial commit' 
heroku create 
git push heroku master 


你 会 看 到 一 个 随机 生成 的 URL 和 Git 远程 地 址 。 以 后 要 部 署 时 ， 只 需要 将 变化 提交 到 Git 库 
中 再 git push heroku master 就 可 以 了 。 程 序 的 名 称 和 UREL 可 以 用 heroku rename 修改 。 

现在 访问 上 一 步 中 生成 的 URL 应 该 可 以 看 到 刚刚 创建 的 Express 程序 了 。 如 果 想 看 日 志 , 五 
以 运行 heroku 1logs; 要 打开 程序 所 在 dyno 的 shell， 可 以 运行 heroku run bash。 

在 Heroku 上 部 署 Node 程序 简单 快捷 ， 无须 针对 Node 做 任何 调整 ，Heroku 默认 就 支持 简单 
的 Node 程序 。 然 而 有 时 需要 对 运行 环境 有 更 多 控制 权 ， 所 以 接 下 来 我 们 要 介绍 如 何在 服务 器 上 
部 署 Node 程序 。 


10.1.2 ”服务 器 


因为 有 些 东西 是 Paag 无 法 提供 的 ， 所 以 我 们 只 能 用 自己 的 服务 器 。 不 用 担心 在 哪里 运行 数 
据 库 ， 只 要 你 愿意 ,可 以 把 PostgreSQL 、MySQL ,甚至 Redis 装 在 同一 台 服 务 器 上 。 你 想 在 服务 
器 上 装 什么 就 装 什么 : 定制 的 日 志 软 件 、HTTP 服务 器 、 缓 存 层 ,你 的 机 器 你 做 主 。 表 10-2 是 使 
用 自己 的 服务 器 的 主要 特性 。 



































表 10-2 服务 器 的 特性 
































易 用 性 低 

功能 全 面 掌控 整 栈 ， 运 行 你 自己 的 数据 库 和 缓存 层 
基础 设施 对 开发 者 (或 系统 管理 员 /DevOps ) 开放 

商业 适用 性 如 果 有 能 维护 服务 器 的 职员 ， 那 很 好 

价格 小 型 VM: $; 大 型 托管 服务 器 : $$$$$ 

厂商 Azure、Amazon、 主 机 托管 商 





有 几 种 办 法 可 以 让 你 拥有 并 维护 自己 的 服务 器 。 可 以 从 Linode 或 Digital Ocean 之 类 的 厂商 
那里 弄 一 台 便宜 的 虚拟 机 ， 然 后 根据 你 的 需要 进行 配置 , 但 硬件 资源 是 跟 其 他 虚拟 机 共享 的 。 可 
以 买 或 租 服 务 器 。 有 些 服务 器 托管 厂商 会 提供 托管 主机 ， 他 们 会 帮 你 维护 服务 器 的 操作 系统 。 

你 必须 决定 用 什么 操作 系统 。Debian 有 好 几 个 分 文 , Node 也 可 以 在 Windows 和 Solaris 上 运 
行 ， 所 以 实际 上 选 起 来 还 是 挺 困 难 的 。 

另外 一 个 很 关键 的 决定 是 如 何 向 外 界 开放 对 程序 的 访问 : 可 以 将 访问 流 从 80 和 443 端口 转 
发 给 你 的 程序 ， 也 可 以 在 前 面部 署 Nginx 做 代理 ， 同 时 让 它 处 理 静 态 文件 。 

把 代码 上 传 到 服务 器 上 办 法 也 很 多 。 可 以 用 scp 、sftp 或 rsync 手动 复制 ， 也 可 以 用 Chef 同 


















































228 第 10 章 “Node 程序 的 部 署 及 运 维 





时 控制 多 台 服 务 器 ， 管 理 版 本 发 布 。 还 有 人 会 搭建 跟 Heroku 一 样 的 Git 钩子 ， 其 可 以 基于 特定 
分 支 上 的 Git 推送 自动 更 新 服务 器 上 的 程序 。 

你 一 定 要 认识 到 自己 管理 服务 器 的 困难 性 。 配 置 服 务 吉 很 费 工 夫 ， 还 要 随时 跟 进 OS 的 错误 
补丁 和 安全 更 新 。 如 果 只 是 业余 爱好 ， 这 些 事情 可 能 会 把 你 搞 垮 ， 但 也 可 能 让 你 学 会 很 多 东西 ， 
并 发 现 自己 对 DevOps 的 兴趣 。 

在 虚拟 机 或 实体 服务 器 上 运行 Node 程序 没有 什么 特殊 要 求 。 如 果 你 想 了 解 在 服务 器 上 运行 
Node 程序 并 保证 它 长 期 运行 的 技术 ， 可 以 跳 到 10.2 节 : 部 署 的 基础 知识 。 不 过 接 下 来 我 们 要 先 
介绍 Node 和 Docker。 























10.1.3 ”容器 


软件 容器 可 以 看 作 是 将 程序 的 部 署 自动 化 的 OS 虚拟 化 技术 。Docker 是 其 中 最 著名 的 项 目 ， 
它 是 开源 的 ， 但 也 提供 生产 程序 部 署 的 商业 性 服务 。 表 10-3 是 容器 的 主要 特性 。 


表 10-3 容器 的 特性 
























































































































































用 性 中 等 

功能 全 面 掌控 整 栈 ， 运 行 你 自己 的 数据 库 和 缓存 层 ， 可 以 重新 部 署 到 各 种 提供 商 和 本 地 机 器 上 

基础 设施 对 开发 者 (或 系统 管理 员 /DevOps ) 开放 

商业 适用 性 非常 棒 : 可 以 部 署 到 托管 主机 、Docker 主机 或 你 自己 的 数据 中 心 上 

价格 3$3$ 

厂商 Azure、Amazon、Docker Cloud 、 Google 云 平 台 ( 带 Kubernetes ) ， 以 及 允许 运行 Docker 容器 
的 主机 托管 厂商 们 





Docker 允许 将 程序 定义 为 映像 。 比 如 要 搭建 一 个 典型 的 由 图 片 处 理 微服 务 、 存 储 程序 数据 的 
主 服 务 和 后 端 数据 库 组 成 的 内 容 管 理 系 统 ， 可 以 分 成 四 个 独立 的 Docker 映像 来 部 署 : 
口 映像 1 一 一 对 上 传 到 CMS 中 的 图 片 进行 缩放 的 微服 务 ; 
口 映像 2 PostgreSQL ; 
口 映像 3 一 一 带 管理 界面 的 CMS 程序 主体 ; 
口 映像 4 一 一 面向 公众 的 前 端 Web 程序 。 
因为 Docker 是 开源 的 ， 所 以 可 以 部 署 Docker 映像 的 厂商 不 止 一 家 。Amazon 的 Elastic 
Beanstalk 、Docker Cloud， 甚 至 Microsoft 的 Azure 都 可 以 部 署 Docker 映像 。Amazon 还 有 EC2 
Container Service (ECS ) 和 做 Git 云 仓 库 的 AWS CodeCommit， 它 们 可 以 像 Heroku 那样 部 署 到 
Elastic Beanstalk 上 。 
在 将 程序 容 需 化 之 后 ， 用 一 条 命令 就 可 以 带 起 一 个 新 鲜 的 实例 ， 这 是 使 用 容器 的 奇妙 之 处 。 
在 拿 到 一 台新 机 器 之 后 ， 你 只 需要 在 上 面 装 好 Docker， 然 后 把 程序 从 库 中 签 出 来 ， 就 可 以 运行 
脚本 启动 程序 了 。 因 为 程序 有 精心 定义 的 部 署 配方 , 所 以 你 和 你 的 合作 者 们 很 容易 理解 它 在 开发 
环境 之 外 应 该 如 何 运 行 。 
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用 Docker 运行 Node 程序 的 例子 

示例 : https://modejs.org/en/docs/guides/nodejs-docker-webapp/ 

要 用 Docker 运行 Node 程序 ， 先 要 做 好 下 面 这 几 件 事 。 

(1) 安装 Docker。 

(2) 创建 一 个 Node 程序 。10.1.1 节 中 有 快速 创建 Express 程序 的 例子 。 

(3) 在 项 目 中 添加 文件 Dockerfile。 

这 个 Dockerfile 会 告诉 Docker 如 何 创建 程序 的 映像 , 以 及 如 何 安装 这 个 程序 并 运行 它 。 在 官 
方 的 Node Docker 映像 中 ，Dockerfile 指定 了 FROM node:boron， 然后 用 RUN 和 cMD 指令 运行 
npm install 及 npm start。 完 整 的 代码 如 下 所 示 : 


FROM node:argon 























RUN mkdir -p /usr/src/app 
WORKDIR /usr/src/app 


COPY package.json /usr/src/app/ 
RUN npm install 


COPY . /usr/src/app 


EXPOSE 3000 
CNMD. Tt "nom startr”d] 


创建 好 Dockerfile 之 后 ， 可 以 在 命令 行 中 运行 aocker bui1lg 构建 程序 的 映像 。 只 需要 指定 
构建 的 目录 ， 比 如 你 在 Express 示例 程序 的 根 目录 下 ， 运 行 docker puila .就 会 创建 它 的 映像 
并 发 送 给 Docker 后 台 。 

docker images 是 查看 映像 列表 的 命令 。docker run -D 8080:3000 -qd <image ID> 
是 根据 映像 ID 运行 指定 程序 的 命令 。 其 中 -pb 8080:3000 是 指 将 内 部 端口 (3000 ) 绑 定 到 本 机 
上 的 8080 端口 ， 所 以 要 用 http://localhost:8080 访问 这 个 程序 。 


10.2 部署 的 基础 知识 


对 于 只 是 想 要 展示 一 下 的 Web 程序 ,或 者 要 在 部 署 到 生产 环境 之 前 测试 一 下 的 商业 程序 ， 
可 能 会 先 简单 部 署 一 下 ， 而 那些 让 在 线 时 长 和 性 能 最 大 化 的 工作 要 往 后 放 。 本 节 会 从 简单 的 、 临 
时 性 的 Git 部 署 开始 讲 起， 逐步 深入 到 如 何 保 证 程序 永 不 掉 线 的 细节 中 。 临 时 性 部 署 不 会 做 跨越 
重启 的 持久 化 工作 ,但 配置 起 来 简单 快速 。 



























































10.2.1 从 Git 库 部 署 


我 们 先 快速 浏览 一 下 用 Git 库 部 署 的 基本 步 又 ， 让 你 有 个 感性 的 认识 。 大 多 数 部 署 都 是 按 下 
面 这 些 步 又 做 的 。 
(1) 用 SSH 连接 到 服务 需 。 
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(2) 如 果 需 要 的 话 ， 在 服务 器 上 安装 Node 和 版 本 控制 工具 ( 比如 Git 或 Subversion )。 
(3) 从 版 本 库 中 将 程序 文件 ， 包 括 Node 脚本、 图片、CSS 样式 表 等 ， 下 载 到 服务 器 上 。 
(4) 启动 程序 。 

下 面 是 用 Git 下 载 程序 文件 后 启动 程序 的 例子 : 


git clone https://github.com/Marak/hellonode.git 
cd hellonode 
node server.js 


跟 PHP 一样，Node 不 是 作为 后 台 任 务 运 行 的 。 所 以 说 ， 如 果 按 我 们 前 面 列 出 的 基本 步骤 计 



































署 ，SSH 连接 关闭 后 程序 就 退出 了 。 不 过 只 需 一 个 简单 的 工具 就 可 以 解决 这 个 问题 。 
自动 化 部 署 


Node 程序 的 部 署 可 以 实现 自动 化 。 比 如 我 们 可 以 用 Fleet 这 样 的 工具 ， 通过 git push 将 
程序 部 署 到 一 到 多 台 服 务 器 上 。 还 可 以 用 Capistrano 这 种 比较 传统 的 方式 ， 有 具体 过 程 请 参见 
Evan Tahler 的 Bricolage 博客 上 发 表 的 文章 “用 Capistrano 部 署 Node.js 程序 ”。 


10.2.2 ”保证 Node 不 掉 线 


假设 你 用 Ghost 博客 程序 创建 了 一 个 个 人 博客 , 部 署 好 后 , 你 肯定 不 想 自己 一 断 开 SSH 连接 
它 就 掉 线 了 。 

Nodejitsu 的 Forever 是 解决 这 个 问题 最 常用 的 工具 。 用 Forever 启动 的 程序 在 你 断 开 SSH 连 
接 后 不 会 退出 ， 并 且 如 果 朋 演 的 话 ，Forever 还 会 重启 它 。 图 10-1 是 Forever 的 工作 原理 概念 图 。 


轩 Forever 启 动 你 的 程序 ， 然 后 对 它 进行 监测 ， | Se 
防止 可 能 出 现 的 崩溃 。 @ 程序 崩溃 后 ，Forever 采 取 行 动 重启 程序 。 


| | | 
1 ! 
启动 及 | 本 重 让 
监测 | 程序 崩溃 监测 


Ea er et 







































































上 路 
名 
ll 
当 


























a a 


图 10-1 Forever 可 以 保证 程序 在 线 ， 甚 至 可 以 在 程序 前 泪 后 重启 它 
全 局 安装 Forever 有 时 需要 用 到 sudo 命令 。 


sudo 命令 全 局 安装 ( 带 参 数 -g ) npm 模块 时 ， 有 时 需要 在 npm 命令 前 加 上 sudo 
以 便 用 超级 用 户 权限 安装 。 第 一 次 用 sudo 命令 时 系统 会 提示 你 输入 密码 ， 验 证 通过 后 
才 会 运行 跟 在 sudo 后 面 的 命令 。 
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接 下 来 用 下 面 的 命令 安装 Forever: 

npm install -g forever 

装 好 Forever 之 后 ， 可 以 用 下 面 的 命令 启动 你 的 博客 并 保持 其 运行 : 

forever start server.js 

如 果 出 于 某 些 原 因 你 要 停 掉 博 客 ， 可 以 用 Forever 的 stop 命令 : 

forever stop server.js 

可 以 用 Forever 的 1ist 命令 查看 它 所 管理 的 所 有 程序 : 

forever list 

Forever 的 男 一 个 比较 实用 的 功能 是 可 以 在 源码 发 生变 化 时 自动 重启 程序 。 让 你 不 用 每 次 添 


加 功能 或 修改 缺陷 后 都 手动 重启 。 
可 以 用 -w 开启 Forever 的 这 一 模式 : 














forever -WwW start server.js 
尽管 Forever 是 特别 好 用 的 部 署 工具 ， 但 可 能 仍 无 法 满足 你 对 长 期 部 署 上 的 功能 需求 。 所 以 
下 一 节 会 介绍 一 些 工 业 级 的 监测 方案 ， 还 要 看 看 如 何 让 程序 性 能 达到 最 优 。 


10.3 在线 时 长 和 性 能 的 最 大 化 


在 程序 值 发 布 后 ， 你 肯定 希望 它 能 在 服务 器 启动 时 启动 ， 在 服务 器 停机 时 关闭 ， 而 且 能 
在 前 泪 后 自动 重启 。 我 们 很 容易 忘记 在 服务 器 重启 之 前 关 停 程 序 ， 或 者 在 服务 器 重启 之 后 启动 
程序 。 

你 肯定 也 希望 自己 做 了 让 性 能 达到 最 优 所 需 做 的 所 有 事情 。 比 如 说 ,如 果 在 四 核 服 务 器 上 只 
用 单 核 跑 你 的 程序 ， 那 么 随 着 Web 程序 的 流量 不 断 攀 升 ， 单 核 的 处 理 能 力 不 足 ， 程 序 的 响应 也 
会 跟 不 上 。 

除了 把 所 有 的 CPU 内 核 都 用 上 ， 在 高 容量 生产 站 点 上 还 应 该 避免 用 Node 提供 静态 文件 。 
Node 擅长 运行 交互 式 程序 ， 比 如 Web 程序 和 TCP/IP 协议 , 在 静态 文件 上 , 它 不 如 那些 专用 的 软 
件 效 率 高 。 应 该 用 Nginx 之 类 的 技术 来 处 理 静 态 文 件 , 它 是 专门 做 这 个 的 。 男 外 也 可 以 把 所 有 更 
态 文 件 都 放 到 内 容 交付 网 络 上 (CDN )， 比 如 Amazon S3， 然 后 在 程序 中 指向 这 些 文件 。 

本 节 会 介绍 一 些 保证 程序 在 线 时 长 和 性 能 最 大 化 的 技术 : 

口 用 Upstart 保 证 程序 在 线 ， 在 服务 器 重启 和 崩 演 后 继续 运行 ; 
口 用 Node 的 集群 API 充分 利用 多 核 处 理 需 的 处 理 能 

口 用 Nginx 提供 Node 程序 中 的 静态 文件 。 

下 面 先 来 看 一 下 强大 易 用 的 Upstart。 
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10.3.1 用 Upstart 保证 在 线 时 长 


比如 说 你 终于 对 程序 感到 满意 了 , 要 把 它 推 向 全 世界 。 那么 你 肯定 无 论 如 何 都 想 要 保证 服务 
器 重启 后 自己 不 会 忘 了 启动 程序 。 你 还 希望 如 果 程 序 表 泪 , 那么 不 能 只 是 自动 重新 启动 它 , 还 要 
记 下 日 志 ， 通 知 你 ， 以 便 让 你 调查 究竟 出 了 什么 问题 。 

Upstart 可 以 优雅 地 管理 所 有 Linux 程序 的 启动 和 关 停 ， 包 括 Node 程序 。Ubuntu 和 CentOS 
的 现代 版 都 支持 Upstart。 在 macOS 上 可 以 创建 launchd 文件 (npm 上 的 node-launchd 可 以 做 这 个 )， 
Windows 上 可 以 用 Windows 服务 和 npm 上 的 node-windows 包 。 

如 果 你 的 Ubuntu 上 还 没 装 Upstart， 可 以 用 下 面 这 个 命令 安装 : 

sudo apt-get install upstart 


在 CentOS 上 用 这 个 命令 : 
































sudo yum install upstart 

装 好 Upstart 之 后 ， 需 要 给 每 个 程序 添加 一 个 Upstart 配置 文件 。 这 些 文件 应 该 放 在 /etc/init 
目录 中 ， 名 称 类 似 于 my _application name.conf。 无 须 给 配置 文件 分 配 可 执行 权限 。 
用 下 面 的 命令 给 本 章 中 的 样 例 程序 创建 一 个 空 的 Upstart 配置 文件 : 
sudo touch /etc/init/hellonode.conf 


接着 将 下 面 的 代码 放 到 配置 文件 里 。 按 照 这 个 配置 ,程序 会 在 服务 器 启动 后 运行 ,在 服务 占 
关闭 时 停止 。Upstart 会 执行 exec 部 分 的 命令 。 


代码 清单 10-1 典型 的 Upstart 配置 文件 




















程序 的 
作者 程序 的 名 
author "Robert DeGrimston" 称 或 描述 i 
在 服务 description "hellonode" 以 用 户 nonrootuser 
器 关闭 setuid "nonrootuser" J- 的 身份 运行 程序 
时 关 停 start on (local-filesystems and net-device-up IFACE=eth0) < 
程序 一 >stop on shutdown 在 服务 器 启动 时 , 等 
—>respawn 将 stain 和 stderr 写 入 文件 系统 和 网 络 准 
在 程序 console log < /var/log/ upstart/yourapp.log 备 好 之 后 运行 程序 
由 巨 运 位 丁子 
env NODE_ENV=production 志 
新 启 

动 它 exec /usr/bin/node /path/to/server.js < 设 定 程序 所 

执行 程序 的 需 的 所 有 环 

命令 境 变 量 











Upstart 会 依照 这 个 配置 文件 保证 你 的 程序 在 服务 器 重启 , 其 至 是 意外 骨 演 后 运行 。 程序 生成 
的 所 有 输出 都 会 放 到 /var/log/upstart/hellonode.log 里 ，Upstart 还 会 帮 你 管理 日 志 的 轮转 。 
创建 好 配置 文件 后 ， 可 以 用 下 面 这 条 命令 启动 程序 : 


sudo service hellonode 
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如 果 程 序 成 功 启动 ， 那 么 你 将 会 看 到 : 

hellonode start/running, process 6770 

Upstart 的 可 配置 化 程度 很 高 。 请 参考 它 的 在 线 文档 了 解 其 配置 项 。 

UPSTART 和 RESPAWNING 

如 果 用 了 respawn 选项 , 在 程序 崩溃 后 ， 只 要 没有 达到 5 秒 内 10 次 的 频率 ，Upstart 默认 会 
一 直 重 新 加 载 它 。 可 以 通过 respawn 1imit COUNT INTERVAL 修改 这 个 默认 的 限制 ， 其 中 couNT 
是 指 在 INTERVAL 秒 内 重新 加 载 的 次 数 。 比 如 可 以 像 下 面 这 样 将 上 限 设 定 为 5 秒 内 20 次 : 


respawn 
respawn limit 20 5 


如 果 程 序 在 5 秒 内 重启 了 10 次 (默认 的 上 限 ), 一 般 是 代码 或 配置 出 错 了 ,基本 不 太 可 能 成 
功 启 动 了 。 达 到 上 限 后 Upstart 就 会 放弃 ， 以 免 占 用 资源 。 

除了 Upstart， 还 应 该 通过 其 他 方式 对 程序 进行 健康 检查 ， 以 便 用 邮件 或 其 他 快捷 的 通信 方 
式 向 开发 团队 报警 。 对 于 Web 程序 来 说 ,健康 检查 可 以 是 简单 地 访问 一 下 ,看 看 能 否 得 到 有 效 的 
响应 。 你 可 以 用 自己 的 办 法 ， 也 可 以 借助 Monit 或 Zabbix 之 类 的 工具 。 

现在 你 知道 如 何 让 程序 撑 过 月 演 和 服务 器 重启 了 , 接 下 来 自然 要 考虑 性 能 问题 。 我们 先 来 看 
看 如 何 用 上 Node 的 集群 API。 


10.3.2 ”集群 APl: 充分 利用 多 核 处 理 器 


现代 计算 机 的 CPU 基本 都 是 多 核 的 ， 但 Node 进程 是 在 单 核 上 运行 的 。 如 果 想 让 Node 程序 
最 大 限度 地 调动 服务 器 的 资源 ， 可 以 在 不 同 的 TCP/IP 端口 上 开启 多 个 程序 实例 ， 然 后 通过 负载 
平衡 将 Web 流量 分 发 到 这 些 实例 上 ， 但 靠 手 动 来 做 的 话 ， 这 个 任务 还 是 比较 艰巨 的 。 

Node 的 集群 API 可 以 让 单个 程序 利用 多 核 处 理 需 。 通 过 这 个 API， 我 们 可 以 轻松 地 让 程序 
同时 在 不 同 的 内 核 上 运行 多 个 工作 进程 , 每 个 做 的 工作 都 一 样 , 用 的 TCP/IP 端口 也 一 样 。 图 10-2 
是 用 集群 API 在 一 个 四 核 处 理 器 上 组 织 工 作 进 程 的 例子 。 































































































































































































图 10-2 ”在 四 核 处 理 器 上 有 一 个 主 进程 和 三 个 工作 进程 


下 面 的 代码 清单 自动 繁殖 了 一 个 主 进程 ， 并 给 另外 的 内 核 每 个 一 个 工作 进程 。 
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代码 清单 10-2 Node 集群 API 演示 
require('cluster'); 
require('http'); 

= require('os') .cpus() .length; 


const cluster 
const http 
const numCpPUs 


确定 服务 器 
< 一 内 核 的 数量 


if (cluster.isMaster) { 
Dt < numCPUs; i++) { < 给 每 个 核 创 
. | 建 一 个 分 又 
cluster.on('exit', (worker, code, signal) => { 
console.log('Worker %s died.', worker.process.pid); 
3 
} else { 定义 每 个 工作 
http.Server((reqg, res) => { < 进程 的 工作 


res.writeHead (200); 
res.end('I am a worker running in process: 
}) .listen(8000); 
} 





因为 主 进程 和 各 个 工作 进程 都 是 各 自 独 立 的 系统 进程 , 所 以 如 果 它 们 分 别 
变量 共享 状态 的 。 但 集群 API 没有 提供 让 主 进程 跟 工 作 进 程 


上 ， 是 无 法 通过 全 局 

















' + process.pid); 


\ 一 人 一 


运行 在 各 自 的 内 核 
通信 的 办 法 。 























下 面 是 一 个 在 主 进程 和 工作 进程 间 传 递 消 息 的 例子 。 主 进程 维护 着 总 请 求 数 ， 当 有 工作 进程 
报告 它 处 理 了 一 个 请 求 后 ， 主 进程 就 会 把 这 个 值 传 给 所 有 工作 进程 。 


代码 清单 10-3 Node 集群 API 的 例子 


const cluster = require('cluster'); 

const http = require('http'); 

const numCPUs = require('os') .cpus().length; 
const workers = {}; 


let requests Os 


if (cluster.isMaster) { 
for (let i = 0; i < numCPUs; i++) { 
workers[i] = cluster.fork(); 
(SS 
workers[i].on('message', (message) => { 


if (message.cmd == 'incrementRequestTotal') { 
增加 总 FSGS No | 
A for (var ] = 0; j < numCPUs; j++) { 
请 求 数 
workers[j] .sendl(t{ 
cmd: 'updateOfRequestTotal', 
requests: requests 
人 
} 
} 
jes 用 闭 包 保留 当前 工 
}) (i); < 一 作 进 程 的 索引 
} 
cluster.on('exit', (worker, code, signal) => { 
console.log('Worker %s died.', worker.process.pid); 


Es 
} else { 


监听 来 自 工作 


< 进程 的 消息 


将 新 的 总 请 求 数 发 
4 一 | 给 所 有 工作 进程 
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a 
process.on('message', (message) => { 4 | 程 的 消息 
if (message.cmd === 'updateOfRequestTotal') { 


requests = message.requests; 
} 
}); 
http.Server( (req, res) 
res.writeHead (200); 
res.end(‘Worker S${process.pid}: 
process.sendl({ cmd: 
}).listen(8000); 
} 


{ 


=> 








10.3.3 ”静态 文件 及 代理 





'incrementRequestTotal' 


根据 主 进程 的 消 
息 更 新 请 求 数 


s{requests} requests..); 


) ) ; 让 主 进程 知道 该 


增加 总 请 求 数 了 


二 | 


通过 Node 集群 API 使 用 多 核 处 理 器 是 种 简单 易 行 的 办 法 。 


尽管 Node 可 以 高 效 地 提供 动态 Web 内 容 ， 但 对 于 图 片 、CSS 样式 表 或 客户 端 JavaScript 这 
些 静态 文件 来 说 , 它 并 不 是 最 有 效 的 办 法 。 最 好 是 让 专注 于 提供 静态 文件 服务 很 多 年 的 软件 来 完 





成 这 项 任务 ， 因 为 它们 是 专门 进行 过 优化 的 。 




















开源 的 Nginx 就 是 专门 提供 静态 文件 服务 的 ， 跟 Node 搭配 起 来 也 很 容易 配置 。 一 般 在 Nginx/ 








Node 的 搭配 中 ， 所 有 请 求 最 初 都 是 到 Nginx 那里 ， 
如 图 10-3 所 示 。 




















图 10-3 用 Nginx 做 代理 将 静态 文件 快速 传 


然后 再 由 它 将 非 静态 文件 的 请 求 发 给 Node。 





回 Web 客户 端 











下 面 这 段 代 码 是 Nginx 配置 文件 中 的 http 部 分 ， 它 就 是 这 样 配置 的 。 在 Unix 服务 需 上 ， 
Nginx 的 配置 文件 一 般 放 在 /etc 目录 下 ， 具 体 路 径 为 /etc/nginx/nginx.conf。 








代码 清单 10-4 ”用 Nginx 做 Node.js 的 代理 并 提供 


http: 
upstream my_node app { 
server 127.0.0.1:8000; 
} 


静态 文件 服务 的 配置 文件 


Node 程序 的 IP 
村 地 址 和 端口 
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server { 指定 接收 请 求 
listen 80; < 的 代理 端口 
server_name localhost domain.com; 
access_log /var/log/nginx/my_node_app.1o0g; 处 理 以 /static/ 开 头 
location ~ /static/ { < 一 一 的 URL 的 请 求 
root /home/node/my_node_app; 
if (!-f Sredquest_filename) { 


return 404; 


} 


} 定义 代理 响应 
location / { 二 的 URL 路 径 


proxy_pass http://my_node_app; 
proxy_redirect off; 
proxy_set_header XxX-Real-IP S$remote addr; 
proxy_set_header X-Forwarded-For S$proxy_add x_ forwarded_ for; 
proxy_set_header Host S$http_host; 
proxy_set_header X-NginXx-Proxy true; 
} 
} 
} 


把 处 理 静 态 Web 文件 的 任务 交 给 Nginx，Node 就 可 以 专心 处 理 它 擅长 的 事情 了 。 
10.4 总 结 


口 Node 程序 可 以 放 到 Paag 提供 商 、 专 用 服务 、 虚 拟 私有 服务 器 和 云 托管 主机 上 。 
口 在 Linux 上 ， 可 以 用 Forever 和 Upstart 快速 部 署 Node 程序。 
口 可 以 借助 Node 的 集群 API 运行 多 个 进程 ， 从 而 提升 程序 的 性 能 。 








超越 Web 开发 





有 上 百 万 人 要 依靠 用 Node 做 的 程序 。Slack 和 Visual Studio Node 就 是 Node 程序 。 这 部 
分 内 容 要 介绍 Electron 和 用 来 编写 命令 行 工具 的 模块 。 如 果 你 曾 想 过 要 为 Linux、macOS 或 
Windows 做 一 个 程序 ， 那 很 快 你 就 可 以 实现 自己 的 愿望 了 。 
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本 章 内 容 

口 按 通 用 惯例 设计 命令 行程 序 
口 管道 通信 

口 使 用 退出 码 














Node 命令 行 工 具 的 应 用 非常 广泛 , 从 Gulp 和 Yeoman 这 样 的 项 目 自动 化 工具 到 XML 和 JSON 
解析 器 ， 几 乎 无 处 不 在 。 如 果 你 想 了 解 如 何 用 Node 制作 命令 行 工 具 ， 可 以 从 本 章 获 取 你 所 需要 
我 们 会 介绍 Node 程序 如 何 接受 命令 行 参 数 ， 如 何 用 管道 处 理 WO， 也 会 介绍 

上 命令 行 用 起 来 更 高 效 的 shell 提示 。 
用 Node 编写 命令 行 工 具 并 不 难 ， 重 要 的 是 按照 社区 的 惯例 来 做 。 本 章 介 绍 了 很 多 这 样 的 惯 
例 ， 以 便 让 你 写 出 别人 无 须 查阅 太 多 文档 就 知道 该 怎么 使 用 的 工具 。 


11.1 了 解 惯例 和 理念 
就 开发 命令 行程 序 而 言 ， 了 解 现 有 程序 所 遵循 的 惯例 是 很 重要 的 工作 。 我 们 以 Babel 为 例 : 





























Usage: babel [options] <files ...> 
Options: 
-h, --help output usage information 
-f, --filename [filenamel] filename to use when reading from 
stdin 
区 六 全 是 
二 人 一 二 CS Don't log anything 
-V, --version output the version number 


这 里 有 几 个 值得 注意 的 点 。 第 一 是 -h 和 up 都 能 输出 帮助 信息 : 很 多 程序 都 支持 这 个 选 
项 。 第 二 是 表示 文件 名 ( fename ) 的 -f 选项 是 很 容易 掌握 的 助 记 符 。 很 多 选项 都 是 用 的 
助 记 符 。 用 -a 表示 输出 的 安静 ( quiet ) a 人 例 ， 另 外 还 可 以 用 -v 来 显示 程序 的 
版 本 〈 version )。 你 的 程序 也 应 该 支持 这 些 选 项 。 

然而 这 些 选 项 不 仅仅 是 惯例 。 使 用 连 字符 和 双 连 字符 ( -- ) 已 经 得 到 了 The Open Group 实 















































用 公约 的 认可 。 "公约 中 甚至 说 明了 应 该 如 何 使 用 它们 ; 
口 准则 4 一 一 所 有 选项 都 应 该 带 有 前 级 -; 
口 准则 10 一 一 第 一 个 非 选项 参数 的 - -参数 都 应 该 当 作 表 明 参 数 结束 的 分 隔 符 。 之 后 的 参数 ， 
即便 以 -字符 开头 的 ， 都 应 该 作为 操作 数 处 理 。 

设计 命令 行程 序 的 另 一 个 重点 是 理念 。 这 可 以 追溯 到 UNIX 的 创造 者 们 , 他们 想 要 设计 可 以 

与 基于 文本 的 简单 界面 一 起 使 用 的 “小 而 锋利 的 工具 ”。 
这 是 UNIX 的 理念 : 编写 只 做 一 件 事 并 能 把 它 做 好 的 程序 ; 编写 能 协作 的 程序 ; 纺 
写 能 处 理 文本 流 的 程序 ， 因 为 那 是 通用 的 接口 。 























一 一 Doug Mcllroy” 
章 会 对 shell 技术 和 UNIX 的 惯例 做 个 全 面 的 概述 ,以 便 帮 你 设计 出 其 他 人 能 用 的 命令 行 工 
章 还 

















shell 技巧 : 获取 帮助 信息 
如 果 你 使 用 shell 时 卡 住 了 ， 可 以 试 试 man <cmd>， 然 后 会 看 到 这 条 命令 的 使 用 手册 。 
如 果 你 忘记 了 某 个 命令 怎么 拼写 ， 可 以 用 apropos <cmd> 在 系统 命令 库 中 搜 一 下 。 


11.2 parse-json 


对 JavaScript 程序 员 来 说 ， 最 简单 实用 的 程序 就 是 读 取 JSON， 如 果 有 效 的 话 就 输出 它们 。 
接 下 来 我 们 会 做 一 个 这 样 的 工具 。 

先 看 一 下 这 个 命令 看 起 来 应 该 是 什么 样 的 。 我 们 和 希望 可 以 像 下 面 这 样 调用 它 : 

node parse-json.js -f my.json 


这 里 要 解决 的 第 一 个 问题 是 怎样 从 命令 行 中 得 到 -f my .json， 也 就 是 这 个 程序 的 参数 。 还 
要 从 stdin 中 读 取 和 输入。 继续 ， 后 面 会 讲 怎么 解决 这 两 个 问题 。 


11.3 ”使 用 命令 行 参数 


虽然 不 是 所 有 ， 但 大 多 数 命令 行程 序 都 会 接受 参数 。Node 本 身 有 处 理 这 些 参数 的 办 法 ,但 
npm 上 的 第 三 方 模块 功能 更 多 。 我 们 需要 用 这 些 功 能 实现 一 些 广泛 使 用 的 惯例 。 继 续 往 下 看 。 


11.3.1 解析 命令 行人 参数 


命令 行 参 数 可 以 从 brocess .argv 数组 中 得 到 。 这 个 数组 中 都 是 运行 命令 时 传 给 shell 的 字 






























































(QD “The Open Group 基本 规范 第 7 期 ”。 
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符 串 。 所 以 如 果 把 命令 切 分 一 下 ， 你 就 知道 数组 中 的 各 个 元 素 分 别 是 什么 了 了。process .argv[0] 
是 node,， process.argv[1] 是 parse-json.js，[2] 是 -f， 以 此 类 推 。 

如 果 之 前 用 过 命令 行程 序 ， 你 应 该 见 过 带 - 或 -- 的 参数 。 这 些 前 缀 是 给 程序 传递 选项 的 特殊 
惯例 ，-- 表 示 后 面 是 参数 的 全 名 ，-- 表 示 后 面 是 代表 参数 的 一 个 字母 。 比 如 npm 命令 的 -n 和 
--helpo 

































































参数 惯例 
其 他 参数 惯例 如 下 : 


四 --version 输出 程序 的 版 本 ; 
上 -y 或 --yes 表 示 其 他 没有 指定 的 参数 全 用 默认 值 。 


给 参数 加 个 别名 ， 比 如 -h 和 --help， 等 参数 多 了 之 后 就 会 觉得 解析 起 来 比较 麻烦 ， 好 在 
有 个 叫 yargs 的 模块 可 以 帮 我 们 解决 这 个 问题 。 下 面 有 个 特别 简单 的 例子 。 只 需要 引入 yargs， 
然后 访问 argv 属性 看 看 给 脚本 传 了 哪些 参数 : 











Const argv = require('yargs') .argyv; 
console.log({ f: argv.f });} 





11-1 给 出 了 Node 自 带 的 命令 行 参数 跟 yargs 生成 的 对 象 之 间 的 差异 。 


node Script.js -f filename -g search --save file 

















1 | = 上- filename 
1 
'-f', 'filename', 
dn 9 2 
| 
[save 上 -| file 
Node 的 process .argv yargs 的 argv 对 象 


图 11-1 Node 的 argv 跟 yargs 的 argv 


虽然 有 进步 , 但 光 有 参数 对 象 还 不 够 ,我们 还 需要 验证 参数 ,生成 使 用 文本 。 下 一 节 会 介绍 
如 何 描述 和 验证 参数 。 


11.3.2 ”验证 参数 





yargs 模块 中 有 验证 参数 的 方法 。 下 面 这 段 代 码 演示 了 如 何 用 yargs 解析 JSON 解析 器 的 参数 
-f， 然 后 用 describe 和 nargs 方法 确保 参数 的 格式 是 正确 的 。 


代码 清单 11-1 用 yargs 解析 命令 行 参 数 
const readFile = require('fs').readFile; 
const yargs = require('yargs'); 
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const argv = yargs 需要 -f£ 才能 运行 


.demand ('f') 7 
-nargs('f', 1) | 他 下] 告诉 yargs -f 后 面 
‘describe('f', 'JSON file to parse') 要 有 参数 值 

.argv; 


const file = argv.f; 

readFile(file, (err, dataBuffer) => { 
const value = JSON.parse (dataBuffer.toString()); 
console.log(JSON.stringify (value)); 

中 


yargs 用 起 来 比 处 理 process .argv 数组 容易 ， 并 且 还 可 以 强化 参数 的 规则 。 代 码 清单 11-1 
用 aemang 表示 这 个 参数 是 必需 的 ， 然 后 声明 它 需 要 一 个 参数 值 ， 应 该 是 要 解析 的 JSON 文件 。 
为 了 让 程序 用 起 来 更 容易 ， 还 可 以 用 yargs 提供 使 用 说 明 。 依 照 惯例 是 见 到 参数 -hn 或 --help 时 
输出 使 用 说 明文 本 。 下 面 是 用 yargs 添加 使 用 说 明 的 例子 : 




















yargs 
A sa 
.usSage ('parse-json [options]') 
.help('h') 
.alias('h', 'help') 
A 


现在 这 个 JSON 解析 器 可 以 接受 文件 参数 了 , 但 我 们 还 没 实现 文件 处 理 功 能 ， 因 为 它 还 需要 
接受 stdin。 接 下 来 我 们 要 学 习 如 何 按照 常用 的 UNIX 惯例 实现 这 一 功能 。 





shell 技巧 : history 
shell 中 有 之 前 输入 过 的 命令 的 记录 。 用 history 可 以 看 到 这 些 记 录 。 它 的 别名 一 般 是 hs。 


11.3.3 将 stdin 作为 文件 传递 


如 果 文 件 是 连 字 符 ( -f - )， 则 表示 要 从 stdin 抓 取 数据 。 这 是 另 一 个 常用 的 命令 行 惯例 。 
用 mississippi 包 做 这 个 很 容易 。 但 在 调用 JsoN.parse 之 前 ， 必 须 把 所 有 传 给 程序 的 数据 合 到 
一 起 ， 因 为 它 要 解析 的 是 完整 的 JSON 字符 串 。 加 上 mississippi 模块 之 后 ， 我 们 的 例子 看 起 来 应 
该 是 这 样 的 。 
代码 清单 11-2 ”从 stdin 读 取 文件 

#!/usr/bin/env node 


const concat = require('mississippi').concat; 
const readFile = require('fs').readFile; 






































const yargs = require('yargs'); 
const argv = yargs 
.usSage('parse-json [options]') 
.help('h') 
.alias('h', 'help') 
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.demand('f') // 需要 -f 才能 运行 
-nargs('f'，1) // 告诉 yargs -f 之 后 需要 跟 一 个 参数 值 
.describe('f', 'JSON file to parse') 
.argv; 

const file = argv.f; 

function parse(str) { 
const Value = JSON.parse (str); 
console.log(JSON.stringify (value)); 

} 


ye 
process.stdin.pipe (concat (parse)); 
} else { 


readFile(file, (err, dataBuffer) => { 
if (err) { 
throw err; 
} else { 
parse (dataBuffer.toString()); 
} 
jy 
下 


这 段 代 码 加 载 mississippi, 调用 它 的 concat 方法 。 然 后 对 stdin 流 进行 concat。 因为 concat 
会 将 完整 的 数据 传 给 那个 作为 它 的 参数 的 函数 ， 所 以 代码 清单 11-1 中 那个 parse 函数 可 以 直接 
拿 过 来 用 。 只 有 文件 名 是 -时 才 会 这 样 做 。 


11.4 用 npm 分 享 命令 行 工具 


如 果 你 想 把 程序 分 享 给 别人 用 ， 那 应 该 让 npm 能 安装 它 。 如 果 想 让 npm 看 的 命令 行程 序 ， 
最 简单 的 办 法 是 用 package.json 中 的 bin 域 。 这 个 域 告诉 npm 装 一 个 当前 项 目 所 有 脚本 都 能 用 的 
可 执行 命令 ， 如 果 在 安装 时 用 了 - -global 参数 ，npm 会 将 这 个 可 执行 命令 安装 到 全 局 环境 中 。 
这 样 不 仅 Node 开发 人 员 能 用 ， 其 他 人 可 能 也 会 用 你 的 脚本 。 

对 我 们 的 JSON 解析 器 来 说 ， 有 下 面 这 段 代码 和 代码 清单 11-2 中 的 #!1/usr/bin/env node 
就 够 了 。 


























"name": "parse-json", 
"hin™ { 
"parse-json": "index.js" 


}, 





如 果 用 npm install -global 安装 这 个 包 ， 那 你 可 以 在 系统 中 的 任何 地 方 调用 parse-json 
命令 。 你 可 以 打开 终端 窗口 (或 Windows 里 的 命令 提示 符 )， 输入 parse-json 试 一 试 。 是 的 ， 
在 Windows 上 也 可 以 ， 因 为 npm 会 自动 安装 一 个 封装 带 ， 计 它 可 以 在 Windows 里 运行 。 














11.5 用 管道 连接 脚本 ”243 





11.5 用 管道 连接 脚本 


parse-json 很 简单 ， 它 只 是 接收 文本 然后 进行 验证 。 如 果 想 把 它 跟 别 的 程序 组 合 起 来 使 用 该 
怎么 办 ? 假设 可 以 给 JSON 文件 添加 语法 高 亮 的 程序 ， 那 就 可 以 先 解析 ， 然 后 再 高 亮 显 示 了 。 本 
节 介 绍 的 管道 技术 可 以 做 成 这 件 事 ， 而 且 不 仅 于 此 。 

借助 管道 技术 ， 我 们 的 parse-json 程序 可 以 跟 其 他 程序 一 起 形成 奇妙 的 工作 流 。Windows 的 
shell 跟 Unix 的 shell 不 同 ， 不 过 还 好 在 关键 点 上 能 保持 一 致 。 在 调试 时 可 能 会 出 现 差异 ,但 对 编 
写 命令 行程 序 应 该 没有 影响 。 


























11.5.1 将 数据 通过 管道 传 给 parse-json 


管道 技术 是 连接 命令 行程 序 的 主要 办 法 。 管 道 能 将 一 个 程序 的 stdout 附着 到 另 一 个 进程 的 
stdin 流 上 ， 是 进程 间 通 信 的 中 间 组 件 。 在 Node 中 ，stdin 是 可 读 流 ， 可 以 通过 process .stdin 
访问 。 下 面 这 条 命令 就 是 解析 来 自 stdin 的 JSON 的 : 


echo "[1,2,3]" | parse-json -f - 
























































注意 命令 中 的 | ， 这 是 告诉 scho "{}" 输 出 到 parse-json 的 stdin 中 。 


shell 技巧 : 键盘 快捷 键 
你 已 经 看 到 管道 怎么 用 了 ， 现 在 可 以 用 它 把 history 和 grep 组 合 起 来 搜索 命令 历史 记录 : 
history | grep node 

甚至 还 可 以 更 简单 ， 即 用 键盘 上 的 向 上 和 向 下 键 翻 看 之 前 的 命令 。 人 们 经 常 这 么 干 ,但 实 
际 上 还 有 更 好 用 的 办 法 ! 用 Ctrl-R 从 命令 历史 记录 里 搜索 , 不 用 一 个 个 翻 ， 直接 调 出 跟 你 提供 
的 文本 部 分 匹配 的 命令 。 

这 样 的 快捷 键 还 有 : Ctrl-S 是 向 前 搜索 ，Ctrl-G 是 放弃 搜索 。 还 可 以 用 快捷 键 更 高 效 地 编 
辑 文 本 : Ctrl-W 是 删除 字 词 ，ALT-F/B 是 向 前 或 向 后 移动 一 个 单词 ，Ctrl-A/E 是 跳 到 一 行 的 开 
头 或 结尾 处 。 


11.5.2 ”处 理 错误 和 退出 码 

目前 这 个 程序 还 没有 输出 任何 结果 。 如 果 你 不 知道 一 个 命令 应 该 输出 什么 , 那么 如 果 提 供 的 
数据 是 错误 的 ,怎样 才能 知道 它 是 否 成 功 完 成 了 呢 ? 答案 是 退出 码 。 你 可 以 看 到 最 后 运行 的 命令 
的 退出 码 ， 不 过 要 注意 ， 因 为 用 了 管道 ， 所 以 echo 和 node 是 被 当 作 一 条 命令 对 待 的 。 

在 Windows 上 ， 可 以 这 样 查 看 退出 码 : 

echo %Serrorlevel% 

在 UNIX 上 ， 可 以 用 这 条 命令 查看 退出 码 : 


echo S? 
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如 果 一 条 命令 是 成 功 完成 的 ， 那 它 的 退出 码 应 该 是 0 (zero )。 所 以 如 果 给 parse-json 的 是 有 
问题 的 JSON， 那 么 退出 码 应 该 是 非 0 值 : 

parse-json -f invalid.json 

运行 上 面 的 命令 , 程序 会 以 非 0 状态 退出 ， 并 输出 一 条 消息 表明 原因 。 当 有 错误 抛 出 但 没有 
被 捕获 时 ，Node 会 自动 退出 并 输出 错误 消息 。 

错误 流 

尽管 在 控制 台中 输出 消息 会 有 帮助 , 但 最 好 还 是 保存 到 文件 中 , 这样 以 后 出 了 问题 需要 调试 
时 还 能 看 到 。 这 在 shell 中 很 容易 实现 ， 只 要 把 stdout 流 重 定向 给 一 个 文件 就 可 以 了 : 




















echo “' 可 以 和 覆盖 文件 | ' > out.log 
echo ' 其 至 还 可 以 追加 到 文件 末尾 | ' >> out .1og 


在 试验 parse-json 对 无 效 的 JSON 的 反应 时 ,很 有 必要 将 错误 消息 保存 下 来 : 
parse-json -f invalid.json > out.log 
但 这 样 就 没有 错误 日 志 了 。 等 你 知道 stderr 和 stdout 之 间 的 区 别 时 , 就 明白 为 什么 会 这 样 了 : 
口 stdout 是 给 其 他 命令 行程 序 用 的 ; 
D stderr 是 给 开发 人 员 看 的 。 
在 调用 了 console.error 或 有 错误 抛 出 时 ，Node 会 记录 到 stderr 中 。 这 跟 scho 不 同 , 它 
是 记录 到 stdout 中 的 ， 就 像 console.1og 一 样 。 了 解 到 这 些 区 别 之 后 ， 你 可 能 想 换 掉 stdout， 
把 stderr 重 定 问 到 文件 中 。 好 在 改 起 来 很 简单 。 
stdin 、stdout 和 stderr 流 都 有 对 应 的 编号 ， 分 别 是 0 到 2。stderr 对 应 的 流 编号 是 2， 可 以 用 
2> out .1o0g 重 定 向 ，shell 看 到 这 个 就 知道 要 将 编号 为 2 的 流 重 定 向 到 文件 out.log 中 : 
parse-json -f invalid.json 2> out.1Log 
管道 所 做 的 事情 就 是 输出 重 定向 ， 不 过 它 针 对 的 不 是 文件 ， 而 是 进程 。 比 如 下 面 的 代码 : 
node -e "console.log(null)" | parse-json 
这 条 命令 记录 了 null 并 将 它 通过 管道 交 给 parse-json。null 不 会 被 输出 到 控制 台 里 ， 因 为 
它 只 会 传 给 下 一 条 命令 。 我 们 换 成 console .error 试 试 : 










































































node -e "console.error (null)" | parse-json 

执行 这 条 命令 会 出 现 错误 ， 因 为 parse-json 没 得 到 任何 数据 。nul1 被 记录 到 stderr 中 了 ,会 
在 控制 台 里 输出 。 数 据 应 该 传 给 stdout， 不 能 给 stderr。 

我 们 可 以 从 图 11-2 看 到 管道 如 何 将 各 个 编号 的 流 与 程序 连接 到 一 起 , 并 将 输出 路 由 到 不 同 的 
文件 中 。 
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nate wl | parse-json -f - > out.json 2> errors.log 


| 


echo " [1 2,，3] ”一 parse-json 
pipe stdout 


stderr 


errors.1og 


图 11-2 ”管道 与 输出 流 的 组 合 


Node 还 有 一 个 可 以 使 用 管道 的 API。 因 为 它 是 基于 Node 流 的 ， 所 以 可 以 用 在 所 有 实现 了 
Node 流 的 类 中 。 接 下 来 我 们 会 继续 解释 管道 在 Node 中 的 使 用 。 
































shell 技巧 : 清除 命令 行 
有 些 命令 特别 长 。 在 需要 删除 一 条 很 长 的 命令 时 该 怎么 办 ?可 以 用 快捷 键 Ctrl-U，, 其 可 以 
删除 当前 行 。 输 入 Ctrl-Y 能 将 这 一 行 命令 再 找 回 来 ， 可 以 像 用 复制 粘贴 一 样 使 用 这 些 快 捷 键 。 


11.5.3 ”在 Node 中 使 用 管道 


接 下 来 介绍 如 何 通过 Node 的 API 使 用 管道 。 我 们 先 写 个 小 脚本 ， 让 它 显示 在 被 管道 中 断 之 
前 程序 运行 了 多 长 时 间 。 

程序 可 以 等 待 stdin 关闭 ， 然 后 将 结果 输出 到 stdout 中 ， 由 此 实现 对 管道 的 监测 。 因 为 没有 
输入 后 Node 程序 就 会 退出 ， 所 以 可 以 在 程序 退出 后 输出 一 条 消息 。 为 了 节省 时 间 ， 你 可 以 直接 
用 下 面 这 段 代码 ， 把 它 存 为 time.js: 

process.stdin.pipe (process.stdout); 

const start = Date.now(); 

process.on('exit', () => { 

const timeTaken = Date.now() - start; 


console.error( Time (s): S${timeTaken / 1000}.); 
J 


可 以 把 time.js 放 在 用 管道 连接 起 来 的 命令 中 间 , 通过 管道 将 数据 送 到 stdout， 让 它们 继续 工 
作 ! 实际 上 ，parse-json 和 time.js 就 可 以 用 管道 连接 到 一 起 来 用 。 比 如 下 面 这 条 命令 会 显示 解析 
JSON 和 发 送 数据 用 了 多 长 时 间 : 


parse-json -f test.json | node time.js 


现在 你 大 概 了 解 输出 什么 和 如 何 从 另外 一 个 程序 那里 得 到 输入 数据 了 , 可 以 开始 制作 更 复杂 
的 程序 了 。 但 我 们 还 要 先 谈 一 下 通过 管道 让 进程 相互 连接 的 时 机 。 















































shell 技巧 : 完成 
除了 命令 历史 记录 ， 大 多 数 shell 都 能 在 你 按 下 Tab 键 时 匹配 命令 或 文件 。 有 些 甚至 可 以 


用 Alt-? 看 到 要 补 齐 哪些 字符 。 

















11.5.4 ”管道 与 命令 的 执行 顺序 
用 管道 连接 起 来 的 命令 都 是 立即 执行 的 。 这些 命 令 不 会 以 任何 形式 相互 等 待 。 也 就 是 说 管道 

不 会 等 到 命令 退出 再 传送 数据 ,并且 命令 只 能 使 用 发 送 给 它 的 数据 。 因 为 没有 等 待 ， 所 以 也 不 知 

道 前 面 的 命令 是 如 何 退 出 的 。 

如 果 你 只 想 在 JSON 成 功 解析 时 才 输 出 消息 , 那 就 要 用 别 的 操作 符 。 当 用 于 数字 时 ，gg 和 | | 

在 shell 里 跟 在 JavaScript 里 的 用 法 差不多 。&& 表示 前 面 的 命令 退出 码 为 0 时 才 执 行 下 一 条 命令 ， 


而 11 表 示 退 出 码 非 0 时 执行 。 
我 们 来 做 一 个 在 进程 退出 时 通过 stderr 输出 消息 的 小 脚本 。 值 得 注意 的 是 它 跟 scho 不 同 ， 


因为 它 输出 到 stderr 中 ， 也 就 是 说 消息 是 给 开发 人 员 看 的 ， 不 是 给 其 他 程序 的 。 你 只 需要 监听 


process 退出 事件 ， 然 后 往 stderr 里 写 参数 就 可 以 了 : 


































































































process.stdin.pipe (process.stdout); 
process.on('exit', () => { 
const args = process.argv.slice(2); 
console.error(args.join(' ')); 


}); 
JSON 解析 成 功 后 用 gg 调用 exit-message.js: 


test.json && node exit-message.js 





parse-json -f "parsed JSON successfully" 


但 exit-message.js 得 不 到 parse-json 的 输出 。&& 操作 符 必须 等 parse-json.js 完成 ,然后 判断 是 
否 应 该 执行 下 一 条 命令 。 使 用 sg 时 不 像 使 用 管道 那样 有 自动 重 定 向 。 


重 定向 输入 
你 已 经 知道 如 何 重 定向 输出 了 ， 实 际 上 用 类 似 的 方式 也 可 以 重 定向 输入 。 虽 然 一 般 不 需要 ， 


但 如 果 可 执行 文件 不 接受 文件 名 参数 ， 就 可 以 用 这 个 办 法 。 如 果 想 将 文件 读 取 到 stdin 中 ， 那 么 
可 以 用 <filename: 
parse-json -f - <invalid.json 


将 两 种 重 定向 结合 起 来 ， 就 可 以 用 临时 文件 恢复 parse-json 的 输出 : 








parse-json -f test.json >tmp.out && 
node exit-message.js "parsed JSON successfully" <tmp.out 


学 会 如 何 处 理 流 、 退 出 码 和 命令 顺序 后 ， 应 该 能 用 Node 命令 给 自己 的 包 写 脚本 了 。 下 一 节 
我 们 将 会 演示 如 何 用 管道 把 Browserify 和 UsglifyJS 结合 起 来 。 





shell 提示 : 清 屏 
有 时 候 你 可 能 会 将 二 进 制 文件 cat 到 终端 上 。 就 像 《 黑 客 帝 国 》 里 的 场景 一 样 ， 屏 幕 上 


全 是 乱码 。 这 时 可 以 按 下 Ctrl-L 来 刷新 终端 窗口 ， 或 者 用 reset 命令 重 置 终端 窗口 。 


11.6 ”解释 真正 的 脚本 


现在 你 已 经 可 以 开始 编写 packagejson 文件 中 的 scripts 域 了 。 比 如 将 browserify 和 uglifyjs 
结合 到 一 起 。Browserify 可 以 把 Node 模块 打包 到 一 起 ， 以 便 在 浏览 器 中 使 用 。UglifyJS 可 以 缩小 
JavaScript 文件 ， 以 便 可 以 用 更 小 的 带宽 和 更 短 的 时 间 发 送 给 浏览 器 。 在 下 面 这 个 例子 中 ，build 
将 会 把 main.js ( 随 书 源码 见 chl1-command-line/snippets/uglify-example ) 相关 的 脚本 合并 到 一 起 ， 


UL 


以 便 可 以 在 浏览 器 中 使 用 ， 然 后 缩小 合并 后 的 脚本 : 


* 
"devDependencies": { 
"brEoOwWSeLElfy S133.0". 
olit yj ToS 
































} 
TBErIDtS: 汪 
"pbuild": "browserify -e main.js > bundle.js && uglifyjs bundle.js > 
bundle.min.js" 
} 
} 
build 的 运行 方式 是 用 命令 npm run builda， 它 会 先 创建 一 个 bundlejs， 如 果 打 包 成 功 ， 再 
创建 bundle.min.js。 因 为 用 的 是 &&， 所 以 能 保证 只 有 第 一 阶段 成 功 后 才 会 运行 第 二 阶段 的 命令 。 
你 可 以 用 本 章 介绍 的 技术 创建 和 使 用 命令 行程 序 。 另 外 , 命令 行程 序 还 可 以 把 其 他 语言 的 脚 


本 结合 到 一 起 ， 比 如 Python 、Ruby 或 Haskell 命令 行程 序 ,都 可 以 轻松 地 用 到 你 的 Node 程序 中 。 












































11.7 ”总结 


口 可 以 从 brocess .atrgv 读 取 命令 行 参数 。 

D yargs 之 类 的 模块 可 以 简化 参数 的 解析 和 验证 。 

口 用 package.json 文件 中 的 scripts 域 可 以 很 方便 地 将 脚本 添加 到 你 的 Node 项 目 中 。 
D 命令 行程 序 用 标准 IO 管道 读 写 数据 。 

口 标准 输入 、 输 出 以 及 错误 可 以 重 定向 到 不 同 的 进程 和 文件 中 。 

口 可 以 根据 程序 发 出 的 退出 码 判断 它们 是 否 成 功 完成 了 。 

口 命令 行程 序 应 该 符合 约定 俗 成 的 惯例 ， 以 符合 用 户 的 使 用 习惯 。 























用 Electron 征服 桌面 








本 章 内 容 

口 用 Electron 搭建 桌面 程序 
口 显示 桌面 菜单 

口 发 送 桌面 提醒 

口 创建 跨 平台 的 版 本 











上 一 章 介绍 了 如 何 用 Node 做 命令 行程 序 。 实 际 上 Node 在 桌面 软件 中 也 慢 慢 流行 开 了 。 程 
序 员 们 渐渐 地 把 Web 技术 用 到 了 路 平台 的 开发 上 。 本 章 要 讲 的 内 容 是 ， 如 何 用 原生 的 桌面 端 功 
能 、Node 和 客户 端 Web 技术 搭建 桌面 端 Web 程序 。 这 个 程序 可 以 在 Linux 、macOS 和 Windows 
上 开发 和 运行 ， 并 且 几 乎 可 以 像 在 客户 端 -服务 器 端 Web 程序 开发 中 那样 使 用 Node 模块 。 


























12.1 认识 Electron 


Electron 原来 叫 Atom Shell， 可 以 用 Web 技术 搭建 桌面 端 程序 。 以 Electron 为 基础 ， 可 以 用 
HTML、CSS 和 JavaScript 实现 程序 逻辑 和 用 户 界面 ， 而 一 些 桌面 端 软件 开发 中 的 “硬骨头 ” 它 
已 经 帮 我 们 解决 了 。 包 括 : 

口 自动 更 新 ; 

口 前 溃 报 告 ; 

口 Microsoft Windows 的 安装 包 ; 

口 调试 ; 

口 原生 菜单 和 提醒 。 

Electron 系 已 经 出 了 几 个 很 著名 的 程序 了 。 最 开始 是 Atom， 即 GitHub 发 布 的 文本 编辑 髓 ， 
最 近 流 行 起 来 的 有 聊天 程序 Slack， 还 有 Microsoft 的 Visual Studio Code， 如 图 12-1 所 示 。 
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生日 @@ app.js - papersonline - Visual Studio Code 





app.useCcool 
app.useCsession({ st 
app.useCexpress. staticCpath. 
app.use(messages); 

.useC' 7api ，a 山 
te 引 Peek Definition 

Go to Definition 
Find All References 
四 。 Go to Symbol 


Change All Occurrences «$8F2 


app.getC"/post 
ra Format Code ), validate. lengthAboveC'entry[titie]', 4), entries.submit); 


routes.notfound(Creq, res, next); 


D; 


人 reactes6 ©@24A0 tn35,Col18 LF Javascrpt 四 


图 12-1 Visual Studio Code 的 程序 窗口 和 原生 上 下 文 菜单 


你 应 该 试 试 这 些 程序 ,看 看 用 Electron 能 做 些 什么 。 想 到 能 用 自己 掌握 的 Node 和 JavaScript 
技术 做 出 这 么 有 吸引 力 的 桌面 软件 ， 还 是 很 振奋 人 心 的 。 


12.1.1 ”Electron 的 技术 栈 


在 开始 介绍 Electron 之 前 ， 要 先 讲 一 下 Electron 是 如 何 跟 Node 、HTML 和 CSS 融合 到 一 起 
的 。Electron 程序 一 般 有 : 
口 主 进程 一 一 启动 程序 的 Node 脚本 ， 提 供 对 原生 Node 模块 的 访问 ; 
口 演 染 进程 一 一 由 Chromium 管理 的 Web 页 面 。 
真正 的 程序 还 会 有 其 他 依赖 项 。 算 上 前 面 提 到 的 ， 包 括 : 
口 主 进程 ; 
口 连接 本 地 数据 库 ( 比如 SQLite ); 
口 跟 Web API 沟通 ; 
口 所 有 本 地 文件 ( 比如 配置 文件 ) 的 读 写 ; 
口 对 原生 功能 ( 比如 上 下 文 菜单 ) 的 访问 ; 
口 演 染 进程 ; 
口 用 你 喜欢 的 客户 端 技术 ( 比如 React 或 Angular ) 显示 富 Web 程序 界面 ; 
口 触发 原生 功能 ( 比如 上 下 文 菜单 和 提醒 ); 
口 提供 构建 脚本 ; 
口 用 你 喜欢 的 构建 系统 ( Grunt、Gulp 、npm 脚本 ) 生成 前 端 JavaScript; 
口 准备 发 布 版 本 。 
12-2 中 给 出 了 典型 Electron 程序 的 三 个 主要 组 成 部 分 。 如 你 所 见 ，Node 负责 运行 主 进程 
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并 跟 操作 系统 沟通 ， 以 便 完成 打开 文件 、 读 写 数据 库 和 跟 Web 服务 通信 等 工作 。 尽 管 泻 染 进程 
的 主要 工作 集中 在 UI 上 ，Node 仍然 是 程序 架构 中 的 关键 构件 。 

















Ce 和 N 


主 进程 [一 加 
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| Chromium (浏览 器 
TML 


浑 染 进程 |------ (Css 与 JS 





























Ln 


Node.js 或 shell 脚 本 | 


ee npm 党 匀 


图 12-2 典型 Electron 程序 的 主要 组 成 部 分 




















12.1.2 ”再 面 设 计 


看 过 Electron 程序 的 主要 组 成 部 分 后 ， 接 下 来 我 们 看 看 如 何 设计 合适 的 界面 。Electron 程序 
的 界面 是 用 HTML、CSS 和 JavaScript 实现 的 ， 不 能 用 原生 部 件 。 比 如 要 实现 Mac 风格 的 界面 ， 
可 以 借助 CSS 渐变 仿造 macOS 工具 条 。CSS 也 可 以 使 用 macOS 和 Windows 上 的 原生 字体 ， 甚 
至 还 可 以 通过 调整 抗 锯 齿 功 能 使 它 看 起 来 跟 原 生 程序 一 样 。 可 以 将 特定 UI 组 件 上 的 文字 选择 去 
掉 ， 支 持 拖 搜 功 能 。 目 前 大 部 分 Electron 程序 所 用 的 颜色 、 边 框 风格 、 图 标 和 渐变 都 跟 macOS 
和 Windows 保持 一 致 。 

有 些 程序 在 复制 原生 体验 上 更 进一步 ， 比 如 N1 email 程序 。 还 有 一 些 程序 ， 比 如 Slack， 有 
自己 独特 的 标识 体系 ， 其 可 辨识 程度 无 须 针 对 每 个 平台 进行 太 多 调整 

在 搭建 Electron 程序 时 ,你 必须 决定 哪 种 方式 更 合适 。 如 果 想 让 它 > 看 起 来 就 是 用 原生 桌面 部 
件 做 的 ， 那 就 要 针对 每 个 平台 准备 一 套 样 式 ， 因 此 需要 投入 更 多 设计 时 间 。 客 户 可 能 会 更 喜欢 ， 
但 也 意味 着 增加 新 功能 时 需要 做 更 多 的 工作 。 

下 一 节 会 用 Electron 程序 框架 创建 一 个 新 程序 ， 这 是 用 Electron 做 新 项 目的 标准 方法 。 










































































12.2 创建 一 个 Electron 程序 


从 electron-quick-start 项 目 开 始 是 最 简单 的 办 法 ， 它 的 GitHub 地 址 见 下 面 的 代码 段 ， 包 含 运 
行 基本 Electron 程序 所 必需 的 依赖 项 。 
检 出 这 个 项 目 ， 安 装 依 赖 项 : 
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git clone https://github.com/atom/electron-quick-start 
cd electron-quick-start 
npm install 


都 下 载 好 之 后 ， 可 以 用 npm start 启动 主 进 程 。 将 这 个 项 目 作为 Electron 程序 的 基础 完全 
没 问题 ; 应 该 不 用 再 从 头 开 始 创建 自己 的 项 目 。 

程序 启动 时 , 应 该 可 以 看 到 一 个 有 Web 页 面 和 Chromium 开发 者 工具 的 窗口 。 如 果 你 是 熟悉 
Chrome 的 Web 开发 人 员 , 可 能 觉得 这 再 平常 不 过 了 : 只 是 一 个 没有 CSS 的 Web 页 面 而 已 。 但 为 
了 这 个 窗口 ，Electron 在 底层 做 了 大 量 的 工作 。 几 12-3 是 这 个 窗口 在 macOS 上 的 样子 。 


煌 Electron Edit View Window Help 








@eD Hello World! 
Hello World! 六 
We are using node 4.1.1, Chrome 45.0.2454.85, and Electron 0.35.4. ee 
Version 0.35.4 (0.35.4) 
ei 
Q 上 日 Eements Network Sources Timeline Profiles Resources Audits lconsolel| 1>_ | 交口 


© 可 <topframe> v Preserve log 


/deep/ combinator is deprecated. See https://www.chromestatus-con/features/6758456638341128 for more details. 











图 12-3 在 macOS 上 运行 的 electron-quick-start 项 


这 是 一 个 自 包 含 的 macOS 程序 包 : 里 面 有 独立 的 Node， 有 自己 的 菜单 项 和 关于 窗口 。 

现在 你 可 以 在 index.html 中 用 HTML、jJavaScript 和 CSS 搭建 Web 程序 了 。 但 考虑 到 作为 Node 
程序 员 的 你 可 能 更 想 看 看 能 用 Node 做 些 什么 ， 我 们 就 先 介 绍 一 下 这 个 吧 。 

Electron 中 有 一 个 remote 模块 ， 是 在 主 Node 进程 和 泻 染 进 程 间 做 进程 间 通 信 (IPC ) 的 。remote 
模块 甚至 还 可 以 提供 对 Node 模块 的 访问 。 我 们 来 试 一 下 ， 在 项 目 中 添加 readfilejs， 代 码 如 下 。 


代码 清单 12-1 简单 的 Node 模块 


const fs = require('fs'); 

















module.exports = (cb) => { 
fs.readFile('./main.js', { encoding: 'utf8' }, cb); 


}; 
打开 index.html， 添 加 一 个 ID 为 source 的 元 素 ， 以 及 加 载 readfile.js 的 脚本 ， 代码 如 下 。 
代码 清单 12-2 ”在 泻 染 进程 中 加 载 Node 模块 


<!DOCTYPE html> 
<html> 
<head> 
<meta charset="UTF-8"> 
<title>Hello World!</title> 
</head> 
<body> 
<hi>Hello World!</hi> 
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<pre id="source"></pre> 


<script> 
Var readfile = require('remote') .require('./readfile'); 
readfile(function(err, text) { 
console.log('readfile:', err, text); 


document .getElementBylId('source').innerHTML = text; 
下 和 
</script> 
</body> 
</html> 


上 面 的 代码 用 remote 模块 加 载 readfile.js, 然后 在 主 进程 里 运行 它 。 两 个 进程 可 以 无 颖 交互 ， 





所 以 看 起 来 跟 使 用 标准 的 Node 模块 没什么 区 别 。 唯 一 的 区 别 是 require('remote') .requir 


( 1 


./readfile');o 


12.3 ”搭建 完整 的 桌面 端 程序 


现在 你 已 经 知道 如 何 创建 基本 的 Electron 程序 了 ， 也 知道 如 何 调用 Node 模块 了 ， 接 下 来 看 











一 下 如 何 搭建 一 个 支持 原生 功能 的 桌面 端 程序 。 这 里 以 能 够 发 起 和 查看 HTTP 请 求 的 开发 工具 为 


例 ， 


便 ， 





看 怎么 做 一 个 带 GUI 的 request 模 块 。 

尽管 只 用 HTML、JavaScript、CSS 和 Node 就 可 以 做 出 Electron 程序 ， 但 为 了 维护 和 扩展 方 
还 是 要 借助 前 端 开发 工具 。 这 个 程序 会 用 到 下 列 内 容 : 

口 以 electron-quick-start 项 目 为 基础 ; 

口 发 起 HTTP 请 求 的 request 模块 ; 

口 做 用 户 界面 的 React; 

口 用 Babel 将 ES6 转 成 对 浏览 器 友好 的 ES5; 

口 构建 客户 端 程序 的 Webpack。 

图 12-4 是 程序 做 好 之 后 的 样子 。 


















































全 有 则 四 HTTP Master 
Request Response (200) 
URL [htpsymtpbinorgidelaylg | 
Method | GET Server nginx 
date Wed, 16 Dec 2015 17:34:38 GMT 
content-type application/json 
ep 六 content-length 235 
User-Agent | HTTP Wizard x connection close 
access-control-allow-origin 
Body Erors 


Make request 





图 12-4 HTTP Master Electron 程序 
接 下 来 介绍 如 何 用 Webpack 和 Babel 搭建 一 个 基于 React 的 项 目 。 
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12.3.1 引导 





React 与 Babel 





搭建 带 有 精巧 前 端的 新 程序 时 ， 最 大 的 挑战 就 是 用 可 维护 的 构建 系统 设置 React 和 Babel 之 
类 的 库 。 要 从 Grunt、Gulp 和 Webpack 这 些 工 具 中 做 选择 是 个 难题 。 何 况 这 些 库 还 在 随 着 时 间 发 
生变 化 ， 相 关 书 籍 和 教程 很 快 就 过 时 了 ， 所 以 这 些 工 作 变 得 更 加 困难 了 。 

为 了 减轻 飞速 发 展 的 前 端 开发 造成 的 影响 , 需要 指定 所 有 依赖 项 的 具体 版 本 号 , 以便 可 以 得 
到 教程 中 所 讲 的 结果 。 如 果 你 被 搞 糊涂 了 ， 可 以 用 Yeoman 之 类 的 工具 生成 程序 框架 。 然 后 按照 














本 章 给 出 的 纲要 进行 修改 。 


12.3.2 ”安装 依赖 项 
创建 新 的 electron-quick-start 项 目 。 从 GitHub 上 克隆 到 本 地 : 


git clone https://github.com/atom/electron-quick-start 
cd electron-quick-start 
npm install 





安装 react、 





react-dom 和 babel-core: 


npm install --save-dev react@0.14.3 react-dom@0.14.3 babel-core@6.3.17 


接着 安装 Babel 插件 。 最 主要 的 是 babel-preset-es2015， 虽然 对 于 一 个 只 是 在 Chromium 运行 


的 项 目 来 说 有 点 儿 大 材 小 用 ， 但 为 了 能 轻松 使 用 Chromium 还 不 支持 的 ES2015 新 特性 








只 好 就 


> 


这 样 了 。 安 装 命令 如 下 : 





npm install 
npm install 


--sSave-dev babel-preset-es2015@6.3.13 
--Save-dqev babel-plugin-transform-class-properties@6.3.13 


让 Babel 支持 JSX 的 插件 : 


npm install 


--Save-dev babel-plugin-transform-react-jsx@6.3.13 


安装 Webpack: 


npm install 


让 Webpack 








npm install 


--Save-dqev webpack@]1 .12.9 


使 用 Babel 的 babel-loader: 





--Save-dev babel-loader@6.2.0 





依赖 项 基本 就 纤 了 ， 在 项 目 中 加 一 个 .babelrc 文件 。 告 诉 Babel 使 用 ES2015 和 React 插 件 : 


{ 


"plugins 


"|[ 


"transform-react-jsx" 


] 5 
J 


} 
最 后 ， 打 开 


: ["es2015"] 


package.json， 在 scripts 里 调用 Webpack: 
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es a 
"start": "electron main.js", 
"build": "node modules/.bin/webpack --progress --colors" 


于 
这 样 运行 npm run build 就 可 以 构建 程序 Ts Webpack 插件 可 以 用 于 React 热 加 载 这 里 
就 不 展开 介绍 了 。 如 果 想 在 客户 端 代 码 发 生变 化 后 自动 完成 构建 ， 可 以 用 fswatch 或 nodemon 之 
类 的 工具 。 














12.3.3 ”设置 Webpack 


Webpack 还 需要 一 个 配置 文件 webpack.config.js。 把 它 放 到 项 目的 根 目 录 下 。 其 基本 格式 是 
使 用 了 Node 风格 CommonJS 模块 的 JavaScript: 


const webpack = require('webpack'); 
module.exports = { 
setting: ' Value' 








] 

这 个 项 目 需 要 的 配置 是 找到 React 文件 ( jsx )， 加 载 程序 人 口 (/app/index.jsx )， 然 后 将 构建 
结果 放 到 Electron UI 能 找到 的 位 置 (js/appjs )。React 文件 还 要 用 Babel 处 理 一 下 。 下 面 就 是 包 
含 上 述 设置 的 配置 文件 。 









































代码 清单 12-3 webpack.config.js 
Const webpack = require('webpack'); 
module.exports = { 
module: { 
loaders: |[ 
{ test: /\.jsx?$/, loaders: ['babel-loader'] } 
] 
和 
entry: [ 
'./app/index.jsx' 
es 


resolve: { 


eXCensionsy .AV :2 
}, 
output: { 

path: __ dirname + '/js', 


filename: 'app.js' 
} 

es 

上 面 的 代码 通过 module .1loaders 告诉 Webpack 用 Babel 转换 .jsx (React ) 文件 。Babel 会 
按照 .babelrc 中 的 设置 用 transform-react-jsx 处 理 React 文件 。 接 下 来 用 entry 属性 定义 React 代 
码 的 主 入 口 。 因 为 React 组 件 是 基于 HTML 元 素 的 ， 而 HTML 元 素 只 能 有 一 个 父 节 点 ， 所 以 可 
以 用 一 个 人 口 赛 括 整个 程序 。 

resolve.extensions 属性 告诉 Webpack 必须 将 .jsx 文件 当 作 模块 处 理 。 如 果 有 ;import 
{Class} from 'class' 之 类 的 语句 ， 它 会 去 找 classjs 和 class.jsx 文件 。 
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最 后 ，output 属性 告诉 Webpack 把 输出 文件 写 到 哪里 。 这 里 用 的 是 js/， 但 实际 上 只 要 是 
Electron UI 能 访问 到 的 路 径 都 可 以 。 

接 下 来 该 介绍 一 下 React 程序 了 。 我 们 先 从 主 入 口 开 始 ， 看 它 是 如 何 将 请 求 和 响应 的 UI 元 
素 拉 进 来 的 。 


12.4 ”React 程序 


12-4 中 有 程序 的 样子 。 其 中 的 UI 元 素 可 以 分 成 两 大 类 ， 七 小 项 。 
口 请 求 
和 URL: 字符 串 。 
和 方法 : 字符 串 。 
am 消息 头 部 ; 包含 字符 串 对 的 对 象 。 
口 响应 
田 HTTP 状态 码 。 
和 消息 头 部 : 包含 字符 串 对 的 对 象 。 
@ 消息 主体 : 字符 串 。 
和 错误 : 字符 串 。 
但 React 中 不 允许 出 现 并 列 的 元 素 ， 必 须 把 它们 放 到 同一 个 父 节 点 中 。 所 以 我 们 需要 一 个 顶 
层 的 App 对 象 ， 包 含 请 求 和 响应 的 UI 元 素 。 
假设 请 求 和 响应 分 别 命名 为 Request 和 Response，App 类 应 该 如 下 所 示 。 




















,TD: 主 3 
代码 清单 12-4 ”App 类 
import React from 'react'; 
import ReactDOM from 'react-dom'; 
import Reduest from './request'; 
import Response from './response'; 


class App extends React.Component { 
render() { 
return ( 
<div className="container"> 
<Request /> 
<Response /> 
</div> 
站 
} 
} 


ReactDOM.render (<App />, document .getElementById('app')); 

将 这 个 文件 保存 为 app/index.jsx。 上 面 的 代码 先 加 载 『 Request 和 Response 类 ， 然 后 放 
在 一 个 aiv 中 泻 染 。 最 后 一 行 用 ReactDOM 演 染 App 类 的 DOM 节点 。React 可 以 用 <App /> 引 
用 App 类 。 

接 下 来 定义 Request 和 Response 组 件 。 
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12.4.1 定义 Request 组 件 


Request 类 接收 输入 的 URL 和 HTTP 方法， 然后 用 Node request 模块 提交 一 个 请 求 。 它 用 
JSX 演 染 用 户 界 面 ， 但 跟 app/index.jsx 中 的 主 类 App 不 同 ，Request 类 不 能 直接 用 ReactDOM 
渲染 元 素 。 

下 面 是 app/request.jsx 的 完整 代码 。 不 过 为 了 节省 篇 幅 ， 我 们 去 掉 了 头 部 编辑 功能 。 可 以 参 
考 GitHub 上 的 HTTP Wizard 项 目 添加 更 多 功能 ， 包 括 头 部 编辑 。 



































代码 清单 12-5” ”Request 类 


import React from 'react'; 
import Events from './events'; 


Const request = remote.require('request'); 


class Request extends React.Component { 
COnstructor(pProps) “{ 
super (props); 
this.state = { url: null, method: 'GET' }; 


handleChange = (e) => { 
const state = {}; 
statele.target.name] = e.target .value; 


this.setState(state); 


makeRequest = () => { 
request (this.state, (err, res, body) => { 
const statusCode = res ? res.statusCode : 'No response'; 
const result = { 
response: `‘(${statusCode})., 


raw: body . ?Dody 2 "7, 
headers: res ? res.headers : [], 
error: err ? JSON.stringify(err, null, 2) 


je 


Events.emit('result', result); 
new Notification( HTTP response finished: S${statusCode}.) 
ss 


render() { 
return ( 
<div className="request"> 
<hl>Request</h1i> 


<div className="request-options"> 
<div className="form-row"> 
<label>URL</label> 
<input 
name="url1" 
type="url" 


12.4 React 程序 257 





value={this.state.url} 
onChange={this.handleChange} /> 
</div> 
<div className="form-row"> 
<label>Method</label> 


<input 
name="method" 
type="text" 








value={this.state.method} 
placeholder="GET, POST, PATCH, PUT, DELETE" 
onChange={this.handleChange} /> 

</div> 

<div className="form-row"> 

<a className="btn" onClick={this.makeRequest}>Make request</a> 
</div> 
</div> 
</div> 
); 
} 
上 


export default Request; 


这 段 代码 中 大 部 分 都 是 render 方法 中 的 HTML。 在 了 解 UI 是 如 何 搭 起 来 的 之 前 ， 我 们 先 
介绍 一 下 其 余 的 部 分 。 首 先是 用 Event Emitter 的 子孙 类 (在 app/events.jsx 中 定义 ) 实现 这 个 
组 件 和 响应 组 件 之 间 的 通信 。 下 面 是 app/events.jsx 的 代码 : 


import { EventEmitter } from 'events'; 
const Events = new EventEmitter(); 
export default Events; 


Request 是 React .Component 的 子孙 类 。 它 的 构造 器 中 会 设置 默认 的 状态 ， 在 React 中 ， 
state 是 个 特殊 的 属性 ， 只 有 在 构造 器 中 才能 直接 赋值 ， 在 其 他 地 方 要 用 this.setState 设置 。 

handleChange 方法 根据 HTML 元 素 的 name 属性 设 定 state。render 方法 中 的 URL 
<input> 元 素 调用 了 这 个 方法 : 













































































<input 
name="url" 
type= "url 


value={this.state.url} 
onChange={this.handleChange} /> 


这 里 指定 name 是 为 了 编辑 时 设 定 URL 的 。state 发 生变 化 时 会 触发 render, 而 React 也 
会 根据 更 新 后 的 状态 修改 value 属性 。 我 们 去 看 看 这 个 类 是 如 何 使 用 request 模块 的 。 

这 是 在 Web 视图 中 运行 的 客户 端 代码 ， 所 以 要 想 办 法 访问 request 模 块 来 制作 HTTP 请 求 。 
Electron 中 有 加 载 远 程 模块 的 办 法 。 这 个 类 先 用 全 局 的 remote 对 象 请 求 了 Node 的 request 模 块 : 


const request = remote.require('request'); 


然后 在 makeRequest 中 简单 地 调用 request () 发 起 HTTP 请 求 。 请 求 的 参数 已 经 在 类 的 
state 中 设 定 了 ， 你 只 需要 处 理 请 求 完 成 时 运行 的 回调 函数 。 下 面 是 一 个 非常 小 的 命令 式 代码 : 
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回调 函数 根据 请 求 的 输出 设 定 state， 然 后 发 出 结果 ， 让 Response 组 件 进行 处 理 。 还 会 显示 
桌面 提醒 。 如 果 请 求 比较 慢 ， 用 户 会 注意 到 操作 系统 的 弹出 提醒 : 


new Notification( HTTP response finished: S${statusCode}.) 


注意 图 12-5 右上 角 的 提醒 。 


县 共 @ 因 60 $0 


会 田 思 Fri18Dec 17:21 QQ 汪 


字 HTTP response finished: 200 


©Oae@ HTTP Master 
Request Response (200) 
URL [mapyocaihost3000 Monder Na sd 
Method [GET x-powered-by Express 
content-type texUhtml; charset=utf-8 
Make request 
content-length 8151 
etag WA1id7-1641067704" 
set-cookie 


Body ”Emors 





图 12-5 ”桌面 端 提醒 
现在 看 一 下 Response 组 件 是 如 何 显示 HTTP 响应 的 。 





12.4.2 ”定义 Response 组 件 


connect.sess=s%3Aj%3A%7B%22_flash%22%3Anull%7D.ZyEm%2F6tnaBnU1wrA 








Response 组 件 监听 result 事件 ， 然 后 根据 上 一 次 请 求 的 结果 设 定 自己 的 state。 它 用 表 


格 显示 消息 头 部 , 用 aiv 显示 消息 体 和 错误 。 
下 面 是 完整 的 Response 组 件 ， 文 件 名 是 app/response.jsx。 








代码 清单 12-6” Response 组 件 


import React from 'react'; 
import Events from './events'; 
import Headers from './headers'; 


class Response extends React.Component { 
constructor(props) { 
super (props); 
this.state = { result: {}, tab: 'body' }; 
3 


componentWillUnmount () { 


Events.removeListener('result', this.handleResult.bind(this)); 
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componentDidMount () { 
Events.addListener('result', this.handlerResult.bind(this)); 


handlerResult (result) { 
this.setState({ result: result }); 








handleSelectTab = (e) => { 
const tab = e.target .dataset.tab; 
this.setState({ tab: tab }); 
} 
render() { 
const result = this.state.result; 
const tabClasses = { 
body: this.state.tab === 'body' ? 'active' : null, 
errors: this.state.tab === 'errors' ? 'active' : null, 
}; 
const rawStyle = this.state.tab === 'body' 
? null 
: { display: 'none' } 
const errorsStyle = this.state.tab === 'errors' 
? null 
{ display: 'none' }; 
return ( 


<div className="response"> 
<hl>Response <span id="response">{result.response}</span></h1> 
<div className="content-container"> 
<div className="content"> 
<div id="headers"> 
<table className="headers"> 
<thead> 
<t¥> 
<th className="name">Header Name</th> 
<th className="value">Header Value</th> 
</EES 
</thead> 
<Headers headers={result.headers} /> 
</table> 
</div> 
<div className="results"> 
<ul className="nav"> 
<li className={tabClasses.body}> 
<a data-tab='body' onClick={this.handleSelectTab}>Body</a> 
去 欠 于 宇 沪 
<li className={tabClasses.errors}> 
<a data-tab='errors' href="#" 
onClick={this.handleSelectTab}>Errors</a> 
</1i> 
</ul> 
<div 
className="raw" 
id="raw" 
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style={rawStyle}>{result.raw}</div> 
<div 

className="raw" 
id="error" 
style={errorsStyle}>{result.error}</div> 

</div> 

</div> 
</div> 
</div> 
) 
} 
} 


export default Response; 


Response 组 件 中 没有 专门 用 来 处 理 HTTP 响应 的 代码 ， 只 是 用 各 种 HTML 元 素 显 示 它 的 
state。 它 可 以 实现 标签 切换 ,实现 机 制 是 将 nandleSelectTab 方法 绑 定 到 onclick 事件 上 ， 








这 个 方法 用 属性 data-tap 实现 消息 体 和 错误 之 间 的 切换 。 














Response 组 件 中 还 用 到 了 泻 染 HTTP 响应 消息 头 部 的 组 件 Headers。 将 组 件 分 解 成 更 小 的 
组 件 是 React 中 的 标准 做 法 。 消 息 头 部 中 的 所 有 值 都 通过 属性 传递 给 子 组 件 ， 在 React 中 ， 它 们 





被 称 为 props 或 properties: 
<Headers headers={result.headers} /> 


下 面 是 Heagders 组 件 ， 文 件 名 是 app/headers.jsx。 








代码 清单 12-7 Headers 组 件 


import React from 'react'; 


class Headers extends React .Component { 


render() { 
const headers = this.props.headers || {}; 
const headerRows = Object.keys (headers) .map( (key, i) 
return ( 


<tr key={i}> 
<td className="name">{key}</td> 
<td className="value">{headers[key]}</td> 
</tr> 
外 
2 


return ( 

<tbody className="header-body"> 
{headerRows} 

</tbody> 

> 
} 


export default Headers; 

















注意 render () 方 法 中 的 this .props .headers， 组 件 就 是 这 样 获取 传递 给 它 的 属性 的 。 
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12.4.3 ”React 组 件 之 间 的 通信 


Request 和 Response 类 隔离 得 相当 好 。 它 们 专注 于 自己 的 任务 ， 不 会 相互 调用 。React 还 
有 其 他 更 精巧 的 状态 管理 方式 ， 这 里 就 不 再 展开 介绍 了 。 这 个 例子 只 有 两 个 主要 组 件 ， 用 
EventEmitter 通信 就 可 以 了 。 
我 们 在 单独 的 文件 app/events.jsx 内 初始 化 Event Emitter， 然 后 输出 它 的 实例 : 


import { EventEmitter } from 'events'; 
const Events = new EventEmitter(); 
export default Events; 


接 下 来 在 组 件 内 引入 events, 或 者 发 出 事件 , 或 者 附着 监听 带 进 行 沟通 。Request 组 件 在 
makeRequest 方法 内 将 HTTP 请 求 的 结果 发 了 出 去 : 

Events .emit ('result', result); 

Response 类 会 用 之 前 在 组 件 生命 周期 方法 中 设置 好 的 监听 器 捕获 这 个 结 


componentWillUnmount () { 
Events.removeListener('result', this.handleResult.bingd(this)); 

































































} 

随 着 程序 中 的 代码 越 来 越 多 , 这 种 模式 会 变 得 越 来 越 难以 维护 。 追踪 事件 的 名 称 都 会 变 得 特 
别 困 难 。 因 为 这 些 名 称 都 是 字符 串 , 所 以 很 容易 忘记 或 写 错 。 一 种 解决 办 法 是 用 常量 列表 做 事件 
名 称 ， 如 果 更 进一步 ， 将 发 送 事件 和 存储 数据 的 职责 分 开 ， 最 终 会 得 到 跟 Facebook 的 Redux 状 
态 容器 类 似 的 东西 ， 所 以 很 多 React 程序 员 都 用 它 设 计 和 搭建 更 大 的 程序 。 


12.5 构建 与 分 发 


现在 这 个 桌面 端 程序 写 完 了 ， 可 以 打包 成 macOS、Linux 和 Windows 上 的 程序 。Electron 程 
序 的 分 发 有 三 个 阶段 。 

(1) 用 你 自己 的 程序 名 称 和 图 标 重 新 定义 Electron 程序 的 标识 。 

(2) 把 程序 打包 到 一 个 文件 中 。 

(3) 为 每 个 平台 创建 一 个 二 进 制 文件 。 

electron-quick-start 基本 上 已 经 具备 分 发 的 条 件 了 。 如 果 是 macOS， 你 只 需要 把 自己 的 代码 
复制 到 Electron 的 Contents/Resources/app 文件 夹 下 ;如果 是 Windows 和 Linux, 则 复制 到 electron/ 
resources/app 文件 夹 下 。 

但 手动 复制 文件 不 是 构建 可 分 发 的 二 进 制 文件 的 最 佳 方式 。 用 Max Ogden 的 electron-packager 
是 更 保险 的 办 法 。 我 们 可 以 用 这 个 包 提 供 的 工具 为 Windows、Linux 和 macOS 构建 可 执行 文件 。 


12.5.1 用 Electron 打包 器 构建 程序 
全 局 安装 electron-packager， 这 样 就 可 以 用 它 构建 ， 为 各 个 平台 创建 相应 的 二 进 制 文 件 : 


npm install electron-packager -9 
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装 好 之 后 ， 在 程序 所 在 目录 下 运行 它 。 调 用 electron-packager 时 必须 提供 程序 路 径 、 名 称 、 
平台 、 架 构 (32- 位 或 64- 位 ) 以 及 Electron 的 版 本 : 

electron-packager . HttpWizard --version=1.4.5 

这 条 命令 会 下 载 1.4.5 版 的 Electron, 为 所 有 支持 的 平台 和 架构 各 生成 一 个 二 进 制 文件 。 这 可 
能 需要 些 时 间 (Electron 大 约 是 40MB ), 但 等 它 完 成 后 ， 你 会 得 到 能 在 各 大 主流 系统 上 运行 的 二 
进 制 文件 。 


隐藏 开发 者 工具 
在 跟 外 界 分 享 你 的 构建 成 果 之 前 ， 应 该 先 把 main.js 中 打开 Chromium 开发 者 工具 那 行 代 
码 删 掉 或 修改 一 下 : 
mainWindow.webContents.openDevTools(); 


或 者 把 它 封 在 一 个 判定 条 件 内 ， 仅 在 调试 时 显示 : 
OG nN = lu 
mainWindow.webContents.openDevTools (); 


y 


12.5.2 打包 


为 进一步 提升 程序 性 能 ， 可 以 用 Atom Shell 归档 工具 将 客户 端 和 Node JavaScript 文件 打包 
到 一 起 。 这 些 归档 文件 也 被 称 为 asar 文件 ， 它 们 就 像 UNIX 的 tar 命令 一 样 。 这 样 虽然 可 以 把 
JavaScript 代码 藏 起 来 ， 但 并 不 能 防止 反 解 码 ， 所 以 不 能 把 它 当 作 代 码 模糊 处 理 的 手段 。 不 过 确 
实 可 以 解决 长 文件 名 在 Windows 中 会 崩 掉 的 问题 ， 有 深度 般 套 的 依赖 项 时 经 常会 碰 到 这 个 问题 。 
在 Electron 中 ，Chromium 可 以 读 取 asar 文件 和 Node 代码 ， 所 以 不 需要 额外 做 什么 。 另 外 ， 
如 果 加 上 --asar 命令 行 选项 ，electron-packager 也 可 以 创建 asar 包 。 
图 12-6 是 没有 asar 时 打包 的 程序 。 


® S app 























app 
build 
css 


HttpWizard-linux-ia32 





HttpWizard-win32-ia32 
® index.html 


js 
LICENSE.md 





webpack.configjjs 








1 0f 15 selected, 5.86 GB available 


图 12-6 ”上 典型 的 Electron 程序 打包 内 容 
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即便 打包 后 ， 仍 然 能 够 看 到 JavaScript 文件 中 的 源码 。 在 Electron 程序 中 ， 只 有 图 片 或 二 进 
制 Node 模块 这 些 资源 性 文件 才 是 二 进 制 文件 。 

可 以 在 electron-packager 命令 中 用 --asar 选项 生成 带 asar 文件 的 构建 结 

electron-packager . HttpWizard --version=0.36.0 --asar=true 

这 种 做 法 是 最 简单 的 , 因为 electron-packager 会 运行 所 有 必须 的 命令 。 如 果 要 手动 来 做 的 话 ， 
需要 先 安装 asar， 然 后 调用 命令 行 工具 来 创建 包 文件 : 


npm install -9 asar 
asar pack path-to-your-app/ app.asar 


有 了 asar 归档 文件 后 ,下 载 需要 支持 的 平台 对 应 的 Electron 二 进 制 文件 , 将 归档 文件 添加 到 
resources 目录 下 ， 如 图 12-6 所 示 。 运 行程 序 的 可 执行 文件 或 包 应 该 就 能 启动 程序 了 。 

Electron 程序 也 可 以 通过 编辑 厂商 提 供 的 二 进 制 文件 来 打上 品牌 。 可 以 用 这 种 办 法 修改 程序 
的 名 称 和 图 标 。 如 果 运 行 没 有 经 过 修改 的 Electron 二 进 制 文件 ， 它 会 提供 一 个 窗口 ， 人 允许 你 运行 
用 electron-quick-start 库 做 的 程序 。 
























































12.6 总结 


口 在 Electron 上 ， 可 以 用 Node、JavaScript、HTML 和 CSS 做 桌面 程序 。 

D 不 用 C++、C# 或 Objective-C 也 可 以 生成 原生 菜单 和 提醒 。 

口 如 果 有 好 用 的 Node 模块 ， 在 Electron 程序 UI 的 客户 端 JavaScript 里 也 可 以 用 。 

口 Electron 用 的 是 成 熟 完 备 的 浏览 絮 ， 所 以 可 以 用 最 新 的 JavaScript 技术 ( 比如 React 或 
Angular ) 搭建 UI。 




















安装 Node 














本 附录 会 详细 介绍 如 何 安装 Nodejs。 如 果 你 刚 开 始 接触 Node， 建 议 使 用 预先 构建 好 的 安装 
程序 ， 每 个 主流 操作 系统 都 有 对 应 的 安装 程序 ， 我 们 会 在 A.1 中 逐一 介绍 


小 <Po 


如 果 你 经 验 更 丰富 , 或 者 有 特殊 的 DevOps 需求 , 想 采 用 其 他 的 安装 方式 , 可 以 直接 参阅 A.2。 








A.1 用 安装 程序 安装 Node 




















Node 有 两 个 安装 程序 和 几 个 预先 构建 好 的 二 进 制 包 。 如 果 你 用 的 是 macOS 或 Windows, 用 
安装 程序 或 二 进 制 包 都 可 以 。 二 进 制 包 中 有 可 执行 文件 ， 安 装 程序 则 有 安装 向 导 ， 可 以 帮 你 把 
Node 放 到 好 找 的 地 方 ， 这 样 在 终端 里 运行 node 或 npm 时 会 更 方便 。 

如 果 你 刚 开 始 接触 Node, 建议 使 用 预先 构建 好 的 安装 程序 。 所 有 版 本 都 能 在 Node 网 站 的 下 
载 页 面 上 找到 。 

















A.1.1 macOS 上 用 的 安装 程序 


要 在 macOS 上 安装 ， 需 要 从 Node 网 站 下 载 64 位 的 .pkg 文件 。LTS 或 Current 版 本 都 行 。 下 
载 好 之 后 应 该 是 如 图 A-1 所 示 那 样 的 一 个 包 文件 ， 双 击 会 出 现 安装 向 导 ( 图 A-2 )。 
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赂 | Downloads 


< s 图 四 ,ol 票 - 六 ~ 村 
Favorites Neme Size Kind Date Added 
训 Dropbox 二 node-v6.70.pkg Today, 16:53 
® AirDrop 

© icloud Drive 








OneDrive 





A: Applications 
于) Desktop 





canndt 


1 item, 120.16 GB available 











图 A-1 安装 程序 .pkg 文件 
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© 亡 Install Nodejs a 
Welcome to the Node.js Installer 


This package will install Node.js v6.7.0 and npm v3.10.3 
-» Introduction into /usr/local/. 


License 
Destination Select 
Installation Type 
Installation 


Summary 


和 @ 
ede 





图 A-2 安装 向 导 
点 击 Continue 按钮 ， 依 照 指 令 用 默认 选项 安装 。 安 装 过 程 结 束 之 后 ， 打 开 终 端 ， 输 入 node 
应 该 会 进入 Node REPL， 如 图 A-3 所 示 。 
Oee 人 alex 一 node 一 node 一 node 一 46x10 





> ~ node 

> console.log('hello world') 
hello world 

undefined 

> 





图 A-3 Node REPL 


下 一 节 将 介绍 在 Windows 上 的 安装 


A.1.2 Windows 上 用 的 安装 程序 


在 Node 网 站 的 下 载 页 面 上 点 击 Windows 安装 程序 图 标 ， 或 者 点 击 安装 程序 的 ,msi 链接 。 有 
32- 位 和 64- 位 两 种 ， 但 一 般 都 是 选 64- 位 的 。 下 载 好 之 后 双击 运行 安装 向 导 ， 如 图 A-4 所 示 。 


了 加 | | 
Welcome to the Node.js Setup Wizard 





Node-v6.7.0-x64. 
msi 


入 过 加 e The Setup Wizard will install Node.js on your computer. 
9 





到 a 





图 A-4 Windows .msi 安装 程序 
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接受 所 有 默认 选项 ， 然 后 打开 cmd.exe 试 一 下 NodeREPL。 图 A-$ 是 NodeREPL 在 Windows 
上 的 样子 。 


Windows [Version 16.6.14393] 
ft Corporation. All rights reserve' 





图 A-5 Windows 上 的 Node REPL 














如 果 你 一 般 不 这 么 安装 软件 ， 或 者 不 想 做 系统 范围 的 安装 ， 可 以 继续 往 后 看 看 其 他 安装 方式 。 





Node 也 可 以 通过 操作 系统 的 包 管 理 器 或 Node 版 本 管理 器 从 源码 安装 。 从 源码 安装 需要 安装 
Python， 还 需要 构建 系统 。 








A.2.1 从 源码 安装 Node 


Node 的 源码 可 以 从 nodejs.org 下 载 页 上 下 载 , 也 可 以 用 git 从 GitHub 上 下 载 。 GitHub 上 还 有 

完整 的 构建 指南 node/Building.md。 构 建 Node 的 前 提 条 件 如 下 。 

口 Linux 一 一 Python2.6 或 2.7, gcc 和 g++4.8 或 以 上 版 本 , 或 clang 和 clang++3.4 或 以 上 版 本 。 

在 Debian 或 其 他 系统 上 ， 都 有 build-essentials 这 样 的 包 可 以 满足 这 一 条 件 。 

口 macOS 一 一 Xcode 和 一 些 可 以 用 Xcode 安装 的 命令 行 工具 。 

口 Windows 一 一 Python 2.6 或 2.7，Visual C++ Build Tools，Visual Studio 2015 Update 3。 
构建 工具 准备 好 之 后 ， 在 类 UNIX 系统 上 运行 ./configure 和 make， 在 Windows 系统 上 

运行 .\vcbuilgd nosign。 














A.2.2 ”用 包 管 理 器 安装 Node 


在 Linux 和 macOS 上 , 用 包 管 理 器 安装 Node 更 新 起 来 更 容易 。 比 如 说 , 如 果 用 的 是 Linux Web 
服务 器 ， 那 你 可 能 希望 自己 安装 的 Node 可 以 自动 安装 安全 更 新 。 

对 于 可 以 用 这 种 形式 安装 的 各 个 操作 系统 ，Node 网 站 上 有 大 量 针对 这 些 系 统 的 安装 指南 。 
比如 在 基于 Debian 和 Ubuntu 的 系统 中 ， 可 以 从 NodeSource 二 进 制 分 发 库 中 获取 Node。GitHub 





上 有 关于 这 个 库 的 更 多 介绍 。 
在 macOS 上 可 以 用 Homebrew 安装 Node。 如 果 装 了 Homebrew, 只 需要 运行 brew install 
node 就 可 以 了 。 


Docker Hub 上 也 有 Node。 在 Dockfile 里 加 上 FROM node:argon 就 能 在 映像 文件 里 装 上 LTS 
版 本 的 Node。 


自动 化 的 网 络 抓 取 








本 附录 包括 

口 从 网 页 创建 结构 化 数据 

口 用 cheerio 实现 基本 的 网 络 抓 取 融 
口 用 jsdom 处 理 动态 内 容 

口 结构 化 数据 的 解析 和 输出 











我 们 之 前 介绍 了 一 些 通用 的 Node 编程 技术 , 接 下 来 要 重点 介绍 一 下 Web 开发 。 因 为 制作 网 
络 抓 取 器 需要 把 服务 器 端 和 客户 端 技术 结合 起 来 , 所 以 其 是 最 理想 的 例子 。 网 络 抓 取 要 识别 Web 
页 面 ， 并 将 其 转换 成 结构 化 数据 。 比 如 说 ， 你 要 负责 升级 出 版 社 那 古老 的 静态 网 站 ， 需 要 把 之 前 
的 页 面 下 载 下 来 ， 经 过 分 析 后 提取 所 有 图 书 的 书 名 、 介 绍 、 作 者 和 售 价 。 你 肯定 不 想 自 己 手 工 完 
成 这 项 任务 ， 所 以 决定 写 个 Node 程序 来 做 这 件 事 。 这 种 程序 就 是 网 络 抓 取 器 。 

Node 特别 适合 做 网 络 抓 取 器 ， 因 为 它 将 基于 浏览 器 的 技术 和 通用 的 脚本 语言 完美 地 融合 在 
了 一 起 。 本 附录 会 介绍 如 何 使 用 HTML 解析 器 基于 CSS 选择 器 提取 数据 , 甚至 在 Node 进程 中 运 
行动 态 Web 页 面 。 


B.1 认识 网 络 抓 取 器 


网 络 抓 取 是 从 网 站 上 提取 有 用 信息 的 过 程 。 通 常会 涉及 下 载 相 关 页 面 、 解 析 ， 然 后 用 CSS 
或 XPath 选择 器 查询 原始 的 HTML。 再 把 查询 结果 输出 为 CSV 文件 或 保存 到 数据 库 中 。 图 B-1 
给 出 了 网 络 抓 取 从 开始 到 结束 的 整个 过 程 。 

因为 资源 有 限 ， 或 不 想 承 担 相 应 的 成 本 ， 有 些 网 站 可 能 很 反感 网 络 抓 取 器 。 如 果 一 个 运行 在 
陈旧 缓慢 的 服务 器 上 的 网 站 要 经 受 上 千 个 网 络 抓 取 器 的 访问 ， 其 很 可 能 会 因 无 力 支撑 而 陷入 瘫 
痪 。 所 以 在 抓 取 之 前 ,要 跟 对方 确 认 是 否 允 许 你 访问 和 复制 他 们 的 内 容 。 从 技术 角度 讲 , 可 以 看 
一 下 对 方 网 站 上 的 robots.txt 文件 ， 但 还 是 应 该 先 联 系 一 下 站 长 。 有 时 候 站 长 可 能 会 邀请 你 索引 
他 们 的 信息 一 一 可 能 是 一 个 大 型 Web 开发 协议 中 的 部 分 内 容 。 
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下 载 页 理 解析 HTML 
<html> { htmle: 
<body> {os 

WE -一 一 下 
</body> } 
</html> } 
-一 一 h3x title 





We 
存 到 数据 库 中 用 选择 器 
进行 查询 


B-1 抓 取 和 存储 内 容 的 步 又 


本 市 会 介绍 人 们 是 如 何在 真正 的 网 站 上 使 用 网 络 抓 取 器 的 ， 然 后 还 会 介绍 以 Node 为 基础 制 
作 网 络 抓 取 带 所 需 的 工具 。 


B.1.1 使 用 网 络 抓 取 器 


垂直 搜索 引擎 Octopart 是 网 络 抓 取 带 中 的 典范 。 如 图 B-2 所 示 ，Octopart 会 索引 电子 分 销 商 
和 制造 商 的 信息 ， 让 人 们 更 容易 找到 电子 产品 ， 比 如 根据 电阻 、 容 差 、 额 定 功率 和 外 过 类 型 搜索 
电阻 器 。 这 样 的 网 站 会 用 网 络 朴 虫 下 载 内 容 , 用 抓 取 器 识别 内 容 并 提取 兴趣 值 ( 比如 电阻 咒 的 容 
差 ) 用 内 部 数据 库存 储 处 理 后 的 信息 。 




















Octopartis a search engine for electronic parts. 
Search across hundreds of distributors and 全 UPLOAD BOM 
thousands of manufacturers. 








Distributors © Manufacturers Categories Attrib More.. 


司 BoM Tool 
图 B-2 ”Octopart 允许 用 户 搜索 电子 元 器 件 
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然而 网 络 抓 取 不 仅仅 用 在 搜索 引擎 上 , 还 用 在 日 益 增长 的 数据 科学 和 数据 新 闻 领域 。 数据 记 
者 用 数据 库 生产 故事 , 但 因为 有 太 多 数据 的 存储 格式 不 太 容 易 访 问 , 所 以 他 们 可 能 会 用 网 络 抓 取 
器 之 类 的 工具 采集 和 处 理 这 些 数据 。 这 样 记者 可 以 用 信息 图 表 和 交互 式 图 形 等 数据 可 视 化 技术 ， 
以 全 新 的 方式 呈现 这 些 信 息 。 











B.1.2 ”所 需 工具 





做 这 件 事 需要 两 种 常见 的 工具 : 浏览 器 和 Node。 浏 览 器 是 最 常用 的 抓 取 工具 之 一 ， 如 果 你 
曾经 点 击 右键 ， 选 择 菜单 项 “检查 元 素 "”， 就 已 经 知道 怎么 识别 网 站 并 将 其 转换 成 原始 数据 了 。 
接 下 来 是 用 Node 解析 这 些 网 页 。 本 章 会 介绍 两 个 解析 器 : 

口 轻便 宽容 的 cheerio; 
口 遵循 Web 标准 的 文档 对 象 模型 (DOM ) 模拟 器 jsdom。 

这 两 个 库 都 可 以 用 npm 安装 。 有 时 可 能 还 需要 解析 松散 的 人 类 可 读 的 数据 格式 ， 比 如 日 期 。 

我 们 会 简单 地 介绍 一 下 JavaScript 的 Date.parse 和 Moment.js。 


B.2 用 cheerio 进行 基本 的 网 络 抓 取 


Felix B6hm 做 的 cheerio 库 特 别 适合 做 网 络 抓 取 ， 它 有 两 个 关键 特性 : 解析 HTML 快 ， 可 以 
用 类 似 于 jQuery 的 API 查询 和 处 理 HTML。 
比如 要 从 出 版 社 的 网 站 上 提取 图 书信 息 , 但 是 因为 网 站 还 没有 这 样 的 API， 所 以 只 能 把 页 面 

下 载 下 来 ， 然 后 将 其 转换 成 包含 作者 和 书 名 等 信息 的 JSON 对 象 。 抓 取 过 程 如 图 B-3 所 示 。 













































































下 载 页 男 解析 HTML 
~ 
<div class="book"> i 
<h2>0aton 22227223 (de 


<h3>Joseph Heller a 
: 


> node index.js 
中 一 一 一 .book h2 
{ titLle: atoeh-22. ea 


以 








</div> : 





” 





author: "Joseph Heller"} 





显示 在 控制 台中 














用 cheerio 查 询 











图 B-3 用 cheerio 抓 取 


下 面 是 一 个 小 型 抓 取 器 的 代码 , 因为 其 中 有 当 作 样 本 的 HIML, 所 以 暂时 还 不 用 管 怎么 下 载 
页 面 。 
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代码 清单 B-1 提取 图 书 的 详细 信息 


卫 "二 mm WY 
ee | 六 要 
的 HTML 
<body> 


<div class="book"> 
<h2>Catch-22</h2> 
<h3>Joseph Heller</h3> 


<p>A satirical indictment of military madness.</p> 


</div> 
</body> 
</html> ; a 
const cheerio = require('cheerio'); 下 | 
const $ = cheerio.load (html); | 文档 


const book = { 
title: $('.book h2').text(), < 一 一 
author: S$(' .book h3') .text()， 
description: $('.book p').text() 
下 





console.1log (book); 


用 CSS 选择 器 
提取 需要 的 域 


在 代码 清单 B-1 中 ,我 们 用 cheerio.1oad() 方 法 和 CSS 选择 器 解析 硬 编码 的 HTML 文档 。 





在 这 样 简单 的 例子 中 ， 用 CSS 选择 器 处 理 起 来 简单 清晰 ， 但 实 


























际 上 我 们 遇 到 的 HTML 通常 要 比 





这 杂乱 得 多 。 想 躲 开 结构 糟糕 的 HTML 几乎 是 不 可 能 的 ， 并 且 你 做 网 络 抓 取 需 的 水 平 主要 取决 














于 你 能 不 能 找到 好 办 法 把 需要 的 值 抓 出 来 。 





识别 糟糕 的 HTML 需要 两 步 。 第 一 步 是 实现 文档 的 可 视 化 ， 第 二 步 是 定义 抽取 目标 元 素 所 


需 的 选择 器 。 用 cheerio 的 功能 特性 定义 选择 器 是 正确 的 方法 。 


























好 在 现在 的 浏览 器 都 能 通过 指向 和 点 击 找到 选择 吉 : 如 果 浏 览 器 有 开发 者 工具 , 一 般 可 以 点 





击 右键 然后 在 弹出 菜单 中 选择 “检查 ”。 你 不 仅 能 看 到 HTML， 





素 的 选择 器 。 
比如 要 从 一 个 古怪 的 网 站 提取 图 书信 息 ， 其 页 面 上 只 有 表 ， 
<html> 
<body> 
<h1>Alex's Dated Book Website</hi1> 
<table> 
有 


<td><a href="/bookl">Catch-22</a></td> 
<td>Joseph Heller</td> 
Ah 
</table> 
</body> 
</html> 








浏览 需 应 该 还 会 显示 指向 目标 元 








根本 没有 CSS 类 ， 就 像 下 面 这 样 : 


在 Chrome 中 打开 这 个 页 面 , 然后 在 书 名 上 点 击 右键 , 选择 “检查 ”, 会 看 到 如 图 B-4 所 示 的 





界面 。 
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全 国人 [| messy_html_example.htm| x Alex | 











[| file:///Users/alex/Documents/Code/nodeinaction/ch03-scraping/snipp... 六 四 | 


Alex's Dated Book Website 


Catch-22 Joseph Heller 














Q [|Elements| Network Sources Timeline Profiles Resources Audits » Ce ,x 
Y <htmL> ] 
这 是 Chrome 加 的 ! <head></head> Styles | Computed » 
真正 的 HTML 中 v <body> element, style +{ 七 硅 常 
根本 没有 这 个 <hl>Alex's Dated Book Website</h1> 二 
经 朋 二 个 。 了 <tabte> a:- user agent stylesheet 
webkit-any-Link { 
Er cotor; -webkit-link; 
可 以 帮 我 们 Y <td> text-decoration3 


<a href="/book1">Catch-22</a> underline; 


找到 选择 器 </td> cursor: auto; 
<td>Joseph Heller</td> } 
人 Inharitad fram tahia 
{nim body table tbody tr td 四 | 


Console | Search Emulation Rendering 








© 可 <top frame> Preserve log 


图 B-4 在 Chrome 中 查看 HTML 








HTML 下 面 有 个 白条 显示 着 “htmlbodytabletbodytrtda”, 这 基本 上 就 是 我 们 需要 的 选择 器 。 
不 过 不 是 特别 正确 ,因为 真正 的 HIML 中 并 没有 tbody。 这 个 元 素 是 Chrome 插 进 去 的 。 在 用 浏 
览 器 查看 文档 时 要 做 好 心理 准备 , 你 看 到 的 可 能 是 经 过 调整 的 HTML。 从 这 个 例子 来 看 , 书 名 在 
表格 单元 的 链接 里 ， 它 后 面 那 个 表格 单元 里 就 是 作者 。 

假设 上 面 的 HTML 放 在 messy_ html example.html 里 ， 那 下 面 就 是 提取 书 名 、 链 接 和 作者 的 
代码 。 


代码 清单 B-2 ”处理 杂乱 的 HTML 











const fs = require('fs'); 
const html = fs.readFileSync('./messy_html_ example.html', 'utf8'); 圭一 一 一 二 = 
const cheerio = require('cheerio'); 从 文件 中 加 
const $ cheerio.load (htm]l); 用 cheerio 的 first 0 载 HTML 
onat Bed et 方法 得 到 指定 的 链接 

title: $('table tr td a').first().text(), < 

nn 
方法 得 到 URL 

用 cheerio 的 eq() 方 

console.1log (book); 法 跳 到 第 二 个 元 素 





由 于 上 面 的 代码 用 外 模块 加 载 7 HTML， 因 此 不 用 在 例子 中 输入 HTML。 在 实际 工作 中 ， 
数据 源 可 能 是 运行 着 的 网 站 , 但 数据 依然 可 能 来 自 文件 或 数据 库 。 文档 经 过 解析 后 , 用 first () 
获取 表格 第 一 个 元 素 中 的 链接 。 用 cheerio 的 attr () 方 法 获取 链接 的 URL， 它 会 像 jQuery 那样 
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返回 元 素 上 的 指定 属性 。eq () 方 法 也 很 有 用 ， 在 上 面 这 段 代码 里 用 它 跳 过 第 一 个 td， 因 为 第 二 
个 里 是 作者 。 





Web 解析 的 危险 
用 cheerio 这 样 的 模块 解析 Web 文档 是 快速 但 粗糙 的 办 法 。 一 定 要 注意 所 解析 内 容 的 类 型 。 
比如 碰 到 二 进 制 数据 时 ， 它 可 能 会 抛 出 异常 ， 所 以 如 果 用 在 Web 程序 中 的 话 ， 可 能 会 导致 Node 
进程 甬 溃 。 如 果 抓 取 器 跟 Web 程序 在 同一 个 进程 里 ， 这 个 程序 就 要 跟着 承担 很 大 的 风险 。 
所 以 在 解析 内 容 之 前 ， 最 好 先 检 查 一 下 。 另 外 尽量 让 抓 取 器 在 独立 的 Node 进程 里 运行 ， 
以 减轻 前 溃 可 能 产生 的 影响 。 








cheerio 的 局 限 之 一 是 只 能 处 理 静 态 文档 ， 它 是 用 来 处 理 纯 HTML 文档 的 ， 不 适合 用 客户 端 
JavaScript 生 成 的 动态 页 面 ,下 一 节 会 介绍 如 何 用 jsdom 在 Node 程序 中 创建 类 似 于 浏览 器 的 环境 ， 
从 而 可 以 执行 客户 端 JavaScript。 


B.3 用 jsdom 处 理 动 态 内 容 


jsdom 是 网 络 抓 取 器 理想 中 的 工具 : 它 能 下 载 HTML， 能 依照 浏览 器 中 出 现 的 DOM 进行 解 
释 ， 还 能 运行 客户 端 JavaScript。 你 可 以 指定 要 运行 的 客户 端 JavaScript， 包 括 jQuery。 也 就 是 说 
你 可 以 把 jQuery (或 定制 的 调试 脚本 ) 注入 到 任何 页 面 中 。 如 图 B-5 所 示 , jsdom 能 将 HTML 和 
JavaScript 结 合 到 一 起 ， 抓 取 到 其 他 工具 访问 不 到 的 内 容 。 



























































下 载 HTML 和 JavaScript 解析 HITML 并 执行 JavaScript 
app.js <div class="book"> { div": 
<h2> class="title"> upon. 
i 
</h2> { } Ser Cie 
~、 Ne } 二 .text('Catch-22') 
</div> } 
jquery.js 














> node index.js 
it 
和 SS 
author: "Joseph Heller"} 


在 控制 台中 输出 














图 B-5 用 jsdom 抓 取 


jsdom 也 有 缺点 。 它 不 能 完美 地 模拟 浏览 吉 ， 它 比 cheerio 慢 ， 它 的 HTML 解析 占 太 严格 ， 
磁 到 写 得 不 好 的 页 面 时 可 能 会 失效 。 然 而 有 些 网 站 完全 依赖 于 客户 端 JavaScript 的 支持 ， 所 以 对 
于 某 些 抓 取 任务 来 说 ，jsdom 是 不 可 或 缺 的 工具 。 

jsdom 的 基本 用 法 是 通过 jsdom.env 方法 。 下 例 演示 了 jsdom 如 何 通过 注入 jQuery 抓 取 页 
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面 并 提取 需要 的 值 。 
代码 清单 B-3 用 jsdom 抓 取 页 面 


const jsdom = require('jsdom'); 


const html = 了 引入 要 处 理 的 


<div class="book"> HTML 代 码 片段 
<h2>Catch-22</h2> 


<h3>Joseph Heller</h3> 
<p>A satirical indictment of military madness.</p> 





人 解析 文档 并 
加 载 jQuery 
jsdom.env (html, ['./node_ modules/jquery/dist/jquery.js'], scrape); < 一 一 


function scrape(err, window) { 
Var §$ = window.s; | 创建 jQuery 对 


$('.book') .each(function() { < 用 jQuery 的 $.each 象 的 别名 以 便 


Var Sel = $ (this); 方法 遍历 图 书 条 目 于 使 用 
console.logl(t{ 


title: S$el.find('h2').text(), < 


author: Sel.find('h3') .text(), 用 jQuery 的 遍 
description: Sel.find('p').text() 历 方法 得 到 图 
}); 书 的 数据 





2 
} 


代码 清单 B-3 需要 保存 在 本 地 的 jQuery 和 jsdom"。 这 两 个 都 可 以 用 npm 安装 ， 模 块 名称 分 
别 是 jQuery 和 jsdom。 一切 准备 就 绪 后 ， 运 行 这 段 代码 应 该 能 在 控制 台中 看 到 HTML 片段 里 的 























书 名 、 作 者 和 介绍 。 
































jsdom.env 方法 是 用 来 解析 文档 及 注入 jQuery 的 。 这 里 注入 的 jQuery 是 用 npm 下 载 到 本 地 
的 ， 不 过 也 可 以 提供 一 个 指向 内 容 交 付 网 络 ( CDN ) 或 文件 系统 上 的 jQuery 的 URL，jsdom 知 
道 该 怎么 处 理 。jsdom.env 方法 是 异步 的 ， 需 要 给 它 一 个 回调 函数 。 这 个 回调 函数 能 收 到 错误 
和 窗口 对 象 ， 我 们 可 以 通过 窗口 对 象 访问 文档 。 为 了 便于 访问 ， 这 里 给 窗口 的 jQuery 对 象 定义 





























了 别名 $。 


选择 带 用 jQuery 的 .each 方法 遍历 每 一 本 书 。 虽 然 这 个 例子 只 有 一 本 书 , 但 已 经 足以 说 明 














jQuery 的 遍历 方法 确实 是 可 用 的 。 图 书 的 所 有 数据 也 是 用 jQuery 的 遍历 方法 得 到 的 。 





代码 清单 B-3 跟 之 前 代码 清单 B-1 中 的 例子 差不多 ， 主 要 区 别 是 由 Node 在 当前 进程 中 解析 
和 执行 的 jQuery。 代码 清单 B-1 用 cheerio 实现 了 类 似 的 功能 ， 那 是 cheerio 自己 的 类 jQuery 层 。 




















这 里 是 像 在 浏览 器 中 那样 运行 这 些 代码 的 。 
jsdom.env 方法 只 在 静态 页 面 中 有 用 。 要 解析 使 用 客户 端 JavaScript 的 页 面 ， 需 要 月 


























有 


jsdom.jsdom。 这 个 同步 方法 会 返回 一 个 窗口 对 象 , 可 以 用 其 他 jsdom 工具 操作 。 下 面 这 段 代码 


用 jsdom 解析 了 一 个 带 script 标签 的 文档 ，jsgdom.jQueryify 让 抓 取 变 得 更 容易 了 。 





@ 编写 本 书 时 是 jsdom 6.3.0。 
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代码 清单 B-4 用 jsdom 解析 动态 HTML 


const jsdom = require('jsdom'); 
const jqueryPath = './node modules/jquery/dist/jquery.js'; < 一 一 





” 指定 jQuery 
const html = 定 
i 路 径 
<div class="book"> 
h2></h2 me 
0 没有 静态 值 
i 的 HTML 
<script> 
document .querySelector('h2').innerHTML = 'Catch-22'; 
document .querySelector('h3').innerHTML = 'Joseph Heller'; 动态 插 
ET 入 值 的 
</div> 脚本 
| 创建 表示 文 
const doc = jsdom.jsdom(html); < | 档 的 对 象 


const window = doc.defaultView; 


jsdom.jQueryify (window, jqueryPath, function() { 
Var $ = window.s$; 


全] 将 jQuery 插 


ee 
$('.book') .each (function() { 入 这 个 文档 
var Sel = $(this); 
console.logl({ 
title: S$el.find('h2').text(), 
”| 提取 图 书 


author: S$el.find('h3').text() 
}) : 

}3 

代码 清单 B-4 需要 安装 jQuery， 如 果 你 是 手工 创建 的 这 段 代 码 ， 那 么 需要 用 npm init 和 
npm install --save jquery jsdom 设置 一 个 新 项 目 。 在 这 段 代码 中 的 HTML 里 ， 我 们 要 
抓 取 的 值 是 动态 插入 进去 的 。 插 入 这 些 值 的 代码 在 文档 的 script 标签 里 。 

这 次 jsdom.env 换 成 了 jsdom.jsdom。 它 是 同步 的 ， 因 为 文档 对 象 是 在 内 存 中 创建 的 ， 
但 在 查询 或 处 理 之 前 不 会 做 什么 。 查 询 和 处 理 文档 的 jQuery 是 用 jsdqom. jcoueryify 插入 到 文 
档 中 的 。 在 jQuery 加 载 和 运行 后 ， 回 调 得 以 执行 ， 从 而 从 文档 中 查询 到 我 们 感 兴趣 的 值 ， 输 出 
到 控制 台中 。 输 出 如 下 所 示 : 

{ title: 'Catch-22', author: 'Joseph Heller' } 

这 说 明 jsdom 已 经 调用 了 必要 的 客户 端 JavaScript。 如 果 把 这 当成 真正 的 Web 页 面 ， 你 就 明 
白 为 什么 说 jsdom 很 强 了 : 即便 是 用 Angular 和 React 这 些 动态 技术 加 上 很 少 的 静态 HTML 做 成 
的 网 站 ，jsdom 也 能 抓 取 。 


B.4 识别 原始 数据 


得 到 有 价值 的 数据 后 ， 还 需要 进行 处 理 ， 以 便 能 够 保存 到 数据 库 中 或 以 CSV 之 类 的 格式 导 
出 。 抓 取 到 的 数据 或 者 是 非 结构 化 的 普通 文本 ， 或 者 是 用 微 格式 编码 的 。 
微 格式 是 基于 标记 的 轻便 数据 格式 ， 用 来 结构 化 地 址 、 日 历 和 事件 、 标 签 或 关键 词 等 数据 。 





的 数据 
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microformats.org 上 有 对 已 有 微 格式 的 介绍 。 下 面 是 一 个 将 名 字 表 示 为 微 格式 的 例子 : 
<a class="h-card" href="http://example.com">Joseph Heller</a> 


微 格式 解析 起 来 很 容易 ， 用 cheerio 或 jsdom, 像 $ ('.h-card') .text () 这 样 简单 的 表达 式 
就 可 以 把 Joseph Heller 提取 出 来 。 但 普通 文本 需要 做 更 多 工作 。 这 一 节 将 会 介绍 如 何 解析 日 期 ， 
并 将 它们 转换 成 更 有 利于 数据 库存 储 的 格式 。 

大 多 数 网 页 都 不 用 微 格式 。 这 里 可 能 会 有 问题 但 依然 可 控 的 是 日 期 值 。 日 期 的 可 能 格式 很 多 ， 
但 在 同一 个 网 站 上 一 般 会 保持 一 致 。 在 识别 出 日 期 的 格式 后 ， 就 可 以 对 其 进行 解析 和 格式 化 了 。 

JavaScript 中 有 内 置 日 期 解析 器 : 运行 new Date('2016 01 01')， 就 会 得 到 对 应 于 2016 
年 1 月 1 日 的 Date 实例。 支持 哪些 输入 格式 是 由 基于 RFC 2822 或 ISO 8601 的 pate.parse 决 
定 的 。 其 他 格式 可 能 能 用 ， 所 以 一 般 要 用 源 数 据 试 一 下 ， 看 看 会 发 生 什么 。 

另外 一 种 办 法 是 用 正则 表达 式 跟 源 数 据 匹 配 ， 然 后 用 Date 的 构造 器 创建 新 的 Date 对 象 。 
其 用 法 如 下 所 示 : 

new Date(year, month minutes[,seconds[,millis]]]]]); 

在 大 多 数 情况 下 ，JavaScript 里 的 日 期 解析 都 够 用 ， 但 对 重新 格式 化 日 期 却 无 能 为 力 。 这 时 
可 以 求助 于 Momentjs， 这 是 一 个 非常 棒 的 日 期 解析 、 验 证 和 格式 化 库 。 有 流畅 的 API， 可 以 像 
下 面 这 样 链 式 调用 : 

moment () .format ("MMM Do YY"); 

这 样 将 抓 取 到 的 数据 转换 成 Microsoft Excel 的 CSV 文件 很 方便 。 比 如 有 一 个 Web 页 面 ， 里 
面 有 图 书 的 名 称 和 出 版 日 期 。 你 要 把 这 些 数据 保存 到 数据 库 里 ， 但 数据 库 的 日 期 格式 是 
YYYYMM-DD。 在 下 面 的 代码 中 ，cheerio 用 Moment 对 数据 进行 格式 化 处 理 。 


代码 清单 B-5 解析 日 期 并 生成 CSV 


'use strict'; 





























day[,hour 























//" Sep 7th 15 








const cheerio = require('cheerio');} 
const fs = require('fs'); 加 载 输 入 
const html = fs.readFileSync('./input.html'); 文件 
const moment = require('moment'); 和 
const § = cheerio.load(html); 引入 moment 
const books = $('.book') 
ee 将 每 本 图 书 都 映射 为 作 
、 书 名 和 其 
author: S$(el).findq('Ph2') .text()， 者 、 书 名 和 出 版 日 其 
title: $(el).find('h3').text(), 
published: S$(el).find('h4').text() 
}; 
} 
.get (); 
CSV 文 件 
console.log('title, author, sourceDate, dbDate'); 的 头 


pooks .forEach( (book) { 


三 > 
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let date = moment (new Date (book.published)); 


console.logl( 

'%S, Ss, %Ss, Ss', 
book.author, 

book.title, 
book.published, 
date.format ('YYYY-MM-DD') 
os 


“|] 解析 日 其 


代码 清单 B-5 需要 cheerio、Moment 和 图 书 数据 ， 它 以 HIML ( input.html ) 为 输入 ， 输 出 


CSV。HTML 中 的 日 期 应 该 放 在 n4 中 ， 如 下 所 示 : 


<div> 
<div class="book"> 
<h23Catecht=22¢ /2 
<h3>Joseph Heller</h3> 
<h4>11 November 1961</h4> 
</div> 
<div class="book"> 
<h2>A Handful of Dust</h2> 
<h3>Evelyn Waugh</h3> 
<h4>1934</h4> 
</div> 
</div> 





抓 取 需 加 载 完 输 入 文件 之 后 又 加 载 了 Moment， 然 后 
一 一 映射 为 JavaScript 对 象 。 .map 方法 会 遍历 这 些 图 书 ， 
方法 从 元 素 中 提取 需要 的 数据 ， 再 用 .get 方法 将 文本 结果 变 成 数组 。 























用 cheerio 的 .map 和 .get 方法 将 图 书 
然后 回调 方法 会 用 . find 选择 器 遍历 





代码 清单 B-5 中 用 console.1og 输出 了 CSV。 先 输出 标题 栏 ， 然 后 在 循环 遍历 中 输出 每 本 
书 的 数据 。 对 于 日 期 , 先是 用 new Date 解析 , 然后 用 Moment 转换 成 可 以 跟 MySQL 兼容 的 格式 。 
习惯 了 日 期 的 解析 和 格式 化 之 后 , 可 以 对 其 他 数据 格式 使 用 类 似 的 技术 。 比 如 用 正则 表达 式 









































B.5 总 结 












































能 够 找到 CSS 选择 右 的 浏览 器 开发 者 工具 。 








于 数据 库 的 格式 。 


捕获 货币 和 距离 度量 数据 ， 然 后 用 Numeral 这 种 通用 的 数值 格式 库 做 格式 化 处 理 。 














口 网 络 抓 取 有 时 是 自动 将 非 结 构 化 的 网 页 转换 成 CSV 或 数据 库 等 对 计算 机 友好 的 格式 。 

口 网 络 抓 取 既 用 于 垂直 搜索 引擎 ， 也 用 于 数据 新 闻 。 

口 在 抓 取 网 站 之 前 应 该 先 查看 网 站 的 robots.txt 文件 ， 跟 站 长 联系 ， 取 得 对 方 许可 。 

口 主要 工具 是 静态 HIML 解析 器 ( cheerio ) 和 能 够 运行 JavaScript 的 解析 器 (jsdom )， 以 及 











口 因为 有 时 数据 的 格式 化 程度 比较 低 ， 所 以 可 能 需要 将 日 期 或 货币 之 类 的 数据 转换 成 适用 
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Connect 对 Node 的 HTTP 客户 端 和 服务 需 模 块 做 了 简单 的 封装 , 其 作者 和 贡献 者 们 又 做 了 一 
官方 支持 的 中 间 件 组 件 , 用 以 实现 一 些 底层 的 功能 ， 比 如 cookie 解析 、 请 求 主体 解析 、 会 话 管 
里 、 基 本 认证 、 跨 站 请 求 伪造 ( CSRF ) 等 ,很 多 Web 框架 都 在 用 这 些 中 间 件 组 件 。 本 附录 对 所 
有 这 些 中 间 件 做 了 介绍 ， 如 果 你 不 想 用 大 型 框架 ,完全 可 以 用 它们 搭建 起 一 个 轻便 的 Web 程序 。 


C.1 解析 cookie、 请 求 主体 和 查询 字符 串 


因为 Node 中 没有 解析 cookie 、 绥 存 请 求 体 、 解 析 复 杂 查 询 字 符 串 之 类 Web 程序 高 层 概念 的 
核心 模块 ， 所 以 Connect 提供 了 实现 这 些 功能 的 中 间 件 。 本 节 会 讨论 三 个 解析 请 求 数据 的 中 间 件 
组 件 : 

D cookie-parser 解析 来 自 浏 览 器 的 cookie， 放 到 *eq.cookies 中 ; 
解析 请 求 URL 的 查询 字符 串 ， 放 到 req. query 中 ; 
D pody-parser 一 一 读 取 并 解析 请 求 体 ， 放 到 reqg .body 中 。 

我 们 先 从 cookie-parser 开始 。 借助 这 个 中 间 件 , 可 以 轻松 获取 存储 在 网 站 访问 者 浏览 器 

中 的 数据 ， 比 如 授权 状态 、 网 站 设置 等 。 


后 
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C.1.1 cookie-parser: 解析 HTTP cookie 


Connect 的 cookie 解析 器 支持 常规 cookie 、 签 名 cookie 和 特殊 的 JSON cookie。req.cookies 
默认 是 用 常规 未 签名 cookie 组 装 而 成 的 。 如 果 需 要 支持 防 算 改 的 签名 cookie， 在 创建 cookie- 
parser 实例 时 要 传人 一 个 加 密 用 的 字符 串 。 


在 服务 器 端 设 定 cookie 中间 件 cookie-parser 不 会 为 设 定 出 站 cookie 提供 任何 
帮助 ,应 该 用 res .setHeader () 函数 设 定 名 为 Set -Cookie 的 响应 头 。 针 对 Set-Cookie 
响应 头 这 一 特殊 情况 ， Connect 为 Node 默认 的 res.setHeaqer () 函 数 打 了 补丁 ， 所 以 
它 可 以 按 你 期 望 的 方式 工作 。 











1. 常规 cookie 
我 们 需要 先 加 载 这 个 模块 ,将 它 添加 到 中 间 件 栈 中 ,然后 才能 读 取 请 求 中 的 cookie。 下 面 是 
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按 这 个 步骤 读 取 cookie 的 例子 。 
代码 清单 C-1 读 取 请 求 中 的 cookie 


const connect = require('connect'); 
const cookieParser = require('cookie-parser'); 加 载 cookie-parser 
中 间 件 

connect () 将 它 添加 到 中 间 件 

.use (cookieparser ()) 栈 中 

.usSe((req, res, next) => { 

res.end(JSON.stringify (req.cookies)); 以 字符 串 形 式 的 
}) cookie 作为 响应 


.listen(3000); 


这 段 代 码 加 载 了 中 间 件 组 件 @。 别 忘 了 先 用 npm install cookie-parser 把 它 装 上 。 然 
后 将 cookie 解析 器 的 实例 添加 到 程序 的 中 间 件 栈 中 人 @。 最 后 一 步 是 以 字符 串 形 式 将 cookie 发 回 
给 浏览 器 合 ， 以 便 你 能 看 到 效果 。 

这 个 例子 需要 在 请 求 中 设 定 cookie。 所 以 用 浏览 器 访问 http://localhost:3000 可 能 看 不 到 什么 ， 
它 会 返回 一 个 空 对 象 ( {} )。 可 以 像 下 面 这 样 用 cURL 设 定 cookie: 

curl http://localhost:3000/ -H “Cookie:foo=bar,bar=baz” 


2. 签名 cookie 

签名 cookie 更 适合 敏感 数据 ， 因 为 用 它 可 以 验证 cookie 数据 的 完整 性 ， 有 助 于 防止 中 间 人 
攻击 。 有 效 的 签名 cookie 被 放 在 regq.signedCcookies 对 象 中 。 把 两 个 对 象 分 开 是 为 了 体现 开 
发 者 的 意图 。 如 果 把 签名 的 和 未 签名 的 cookie 放 到 同一 个 对 象 中 ， 常 规 cookie 可 能 就 会 被 改造 ， 
仿冒 签名 的 cookie。 

签名 cookie 看 起 来 像 s:tobi .DDm3AcVxE9oneYnbmpqxoy[...]," 一样， 点 号 (. ) 左边 
是 cookie 的 值 ， 右 边 是 在 服务 器 上 用 SHA-256 HMAC 生成 的 加 密 哈 希 值 ( 基于 哈 希 的 消息 认证 
码 )。 如 果 cookie 的 值 或 者 HMAC 被 改变 的 话 ，Connect 的 解 签 会 失败 。 

假设 你 设 定 了 一 个 键 为 name， 值 为 luna 的 签名 cookie。cookieParser 会 将 cookie 编码 
为 s:Iuna.PQOLMOwNvcOQoEObZX [ . . .] 。 每 个 请 求 中 的 哈 希 值 都 会 检查 ， 如 果 cookie 完好 无 损 
地 传 上 来 ， 那 么 它 会 被 解析 为 req.signedCookies.name: 


$ curl http://localhost:3000/ -H "Cookie: 
w name=s:luna.POLMOwNvAqOOEObZXU [...] " 

{} 

{ name: 'luna' } 

GET / 200 4ms 


如 果 cookie 的 值 变 了 ， 像 下 一 个 curl 命令 那样 ，cookie name 会 被 解析 为 req .cookies. 
name ， 因 为 它 是 无 效 的 。 但 仍 可 用 来 调试 或 满足 程序 的 特定 需要 : 
$ curl http://localhost:3000/ -H "Cookie: 


ww name=manny .POLMOwNvaqOOEOb [..] " 
{ name: 'manny.POLMOwNvaqOOEOb [.] ' } 













































































Qz 这 是 缩写 后 的 签名 值 。 
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{让 
GET / 200 lms 


cookieParser 的 第 一 个 参数 是 用 来 对 cookie 签名 的 密 钥 。 下面 这 段 代 码 中 用 的 密 钥 是 tobi 
ls a cool ferret。 
代码 清单 C-2 解析 签名 cookie 

const connect = require('connect'); 


Const cookieParser = require('cookie-parser'); 
const secret = 'tobi is a cool ferret'; 





签名 cookie 是 自动 添加 
到 request 对 象 中 的 


connect () 

.usSe (cookieParser (secret)) 

.use((req, res) => { 
console.log('Cookies:', req.cookies); 
console.log('Signed cookies:', req.signedCookies); 从 request 对 象 中 访问 
res.end('hello\n'); 签名 的 cookie 

}) .listen(3000); 

在 这 个 例子 中 , 因为 cookieParser 中 间 件 组 件 中 有 参数 secret, 所 以 签名 cookie 是 自动 
解析 的 @。 解 析 结 果 在 request 对 象 中 @。cookie-parser 模块 的 cookie 解析 功能 还 可 以 通 
过 signedCookie 和 signedCookies 方法 调用 。 

在 介绍 JSON cookie 之 前 ， 我 们 先 看 一 下 如 何 使 用 这 个 例子 。 对 于 代码 清单 C-1 来 说 ， 可 以 
用 带 -H 选项 的 curl 发 送 cookie。 但 签名 cookie 需要 按 某 种 方式 进行 编码 。 

signedCookie 方法 是 用 Node 的 crypto 模块 解 签 的 。 如 果 想 试验 一 下 代码 清单 C-2， 需 要 
安装 cookie-signature， 然后 用 相同 的 密 钥 签 名 一 个 字符 串 : 





























const signature = require('cookie-signature'); 
const message = 'luna'; 
const secret = 'tobi is a cool ferret'; 


console.log(signature.sign(message, secret); 

如 果 签 名 或 消息 被 改 掉 了 ， 服 务 器 能 判断 出 来 。 除 了 签名 cookie， 这 个 模块 还 支持 JSON 编 
码 的 cookie。 我 们 接 下 来 就 介绍 它 。 

3. JSON cookie 

特别 的 JSON cookie 带 有 前 级 j :, 用 以 告诉 Connect 它 是 一 个 串 行 化 的 JSON。JSON cookie 
既 可 以 是 签名 的 ， 也 可 以 是 未 签名 的 。 

Express 之 类 的 框架 可 以 用 这 个 功能 给 开发 人 员 提 供 更 直观 的 cookie 接口 ， 而 不 是 让 他 们 手 
工 做 JSON cookie 值 的 串 行 化 和 解析 工作 。 下 面 是 Connect 解析 JSON cookie 的 例子 : 


$ ‘Curl nttp: /lo6calhiost :3000/ =H: ‘CookKkiés f00=Bar., 
bar=I "foo. ary 

tteoo% bar'. bars {too bar } } 

{} 

GET / 200 lms 


就 像 前 面 提 到 的 ，JSON cookie 也 可 以 是 签名 的 ， 比 如 像 下 面 这 个 请 求 中 这 样 的 : 
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$ curl http://localhost:3000/ -H "Cookie: 
ww cart=j:{\"items\":[1]}.sD5pP6xFFBO/4ketAl1OP43bcjS3Y" 


0 

{ cart: { items: [ 1 ] }} 

GET / 200 lms 

4. 设 定 出 站 cookie 

我 们 之 前 提 到 过 ，cookie-parser 模块 没有 提供 任何 通过 Set -cookie 响应 头 向 HTTP 客 
户 端 写 出 站 cookie 的 功能 。 但 Connect 可 以 通过 res .setHeader () 图 数 写 人 多 个 set -Cookie 
响应 头 。 


假设 你 想 设 定 一 个 名 为 foo, 值 为 字符 串 bar 的 cookie。 调用 res .setHeader (),， Connect 








让 你 用 一 行 代码 搞定 。 你 还 可 以 设 定 cookie 的 各 种 选项 ， 比 如 有 效 期 , 像 下 面 的 第 二 个 setHeager () 
一 样 : 
var connect = require('connect'); 
connect () 
.usSe((req, res) => { 
res.setHeader ('Set-Cookie', 'foo=bar'); 
res.setHeader ('Set-Cookie', 
'tobi=ferret; Expires=Tue, 08 Jun 2021 10:18:14 GMT' 
有 
res.end(); 


}) 
.listen(3000); 


如 果 用 curl 的 --head 标记 检查 这 个 服务 器 对 HITP 请 求 的 响应 ， 应 该 能 看 到 set -Cookie 
响应 头 : 


$ curl http://localhost:3000/ --head 

HTTP/1.1 200 OK 

Set-Cookie: foo=bar 

Set-Cookie: tobi=ferret; Expires=Tue, 08 Jun 2021 10:18:14 GMT 


Connection: keep-alive 

在 HTTP 响应 中 发 送 cookie 的 知识 全 在 这 里 了 。 你 可 以 在 cookie 中 存放 任意 类 型 的 文本 数 
据 , 但 通常 是 在 客户 端 存 放 一 个 会 话 cookie， 这 样 你 就 可 以 在 服务 器 端 保留 完整 的 用 户 状态 。 这 
项 会 话 技 术 封 装 在 express-session 模块 中 ,我 们 稍 后 再 介绍 。 

你 已 经 知道 怎么 处 理 cookie 了 ， 现 在 可 能 急切 地 想 知道 处 理 其 他 接收 用 户 输入 的 常用 方法 。 
后 面 两 节 将 会 介绍 查询 字符 串 和 请 求 消息 主体 的 解析 ， 你 会 发 现 ， 尽管 Connect 是 比较 底层 的 框 
架 ， 但 我 们 要 实现 更 加 复杂 的 Web 框架 所 提供 的 功能 并 不 需要 写 太 多 代码 。 


C.1.2 解析 查询 字符 串 
GET 参数 是 接受 输入 的 办 法 之 一 。 在 URL 后 面 加 一 个 问号 , 后 面 是 用 & 号 分 开 的 一 列 参数 : 
http://localhost:3000/page?name=tobi&species=ferret 
设 定 为 用 GET 方法 提交 的 表单 ， 以 及 页 面 模板 中 的 链接 元 素 都 会 产生 这 样 的 URL。 比 如 常 
见 的 分 页 链接 。 
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在 Connect 程序 中 ， 传 给 每 个 中 间 件 的 request 对 象 中 都 有 url 属性 ， 但 一 般 只 需要 最 后 
部 分 , 即 问号 之 后 的 那些 。Node 有 URL-parsing 模块 , 所 以 从 技术 角度 来 讲 , 可 以 用 url .parse 
获取 查询 字符 串 。 但 Connect 也 要 解析 URL， 所 以 它 将 解析 过 的 版 本 设 为 了 一 个 内 部 属性 。 

推荐 使 用 qs 解析 查询 字符 串 。 这 不 是 Connect 官方 的 模块 ，npm 上 也 有 很 多 替代 模块 。as 
及 类 似 的 模块 的 用 法 都 是 在 其 他 中 间 件 中 调用 它 的 .parse() 方 法 。 

基本 用 法 

下 面 这 段 代 码 用 qs .parse 方法 创建 了 一 个 对 象 ， 并 赋值 给 req .query 属性 供 后 续 中 间 件 
组 件 使 用 。 


代码 清单 C-3 解析 查询 字符 串 


























const connect = require('connect'); 
const qs = require('gs'); 
connect () 
.usSe((req, res, next) => { 
console.log(req._parsedUrl .query); 用 as 解析 查询 
req.query = qs.parse(req._parsedUrl .query); 字符 串 
next (); 
} 
.usSe((req, res) => { 
console.log('gquery string:', req.query); NE 一 a 
res.end('\n'); ds 


小 
.listen(3000); 


在 上 面 这 段 代码 中 ， 我 们 用 中 间 件 组 件 获 取 解 析 过 的 URL， 然 后 用 qs .parse 对 它 进行 解 
析 @， 并 在 后 面 的 中 间 件 里 显示 解析 结果 。 

假定 你 要 构建 一 个 音乐 库 程 序 ， 需要 实现 搜索 功能 ， 则 可 以 用 查询 字符 串 提 交 搜 索 参数 ， 比 如 : 

/songSearch?artist=Bob%20Marley&track=Jammin. 

这 个 查询 会 产生 下 面 这 样 的 req .query 对 象 : 

{ artist: 'Bob Marley', track: 'Jammin' } 

qs.parse 方法 支持 艇 人 数组 ， 所 以 像 ?images[]=foo.png&images[]= bar.png 这 样 
的 复杂 查询 会 生成 下 面 这 种 对 象 : 

{ images: [ 'foo.png', 'bar.png' ] } 

如 果 在 HTTP 请 求 中 没有 查询 字符 串 参 数 ， 那 么 像 /songSearch，req.query 这 样 的 会 默 
认为 空 对 象 

{} 

对 于 Web 开发 来 说 ,这 是 非常 基本 的 需求 ,所 以 Express 之 类 的 高 层 框 架 一 般 都 有 自己 的 查 
询 字符 串 解析 。Web 框架 的 另外 一 个 基本 需求 是 解析 请 求 消 息 主 体 , 以便 获取 表单 中 提交 上 来 的 
数据 。 下 一 节 会 介绍 如 何 解析 请 求 消息 主体 ， 处 理 表单 和 文件 上 传 ， 并 对 这 些 请 求 进行 验证 以 确 
保 其 安全 性 。 
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C.1.3 body-parser: 解析 请 求 主体 


大 多 数 Web 程序 都 需要 接受 并 处 理 用 户 的 输入 。 可 能 是 来 自 表 单 的 数据 ， 甚 至 也 可 能 是 通 
过 RESTful API 由 其 他 程序 传 来 的 数据 。HTTP 请 求 和 响应 被 统称 为 HTTP 消息 ， 由 一 组 消息 头 
和 一 个 消息 体 组 成 。 在 Node Web 程序 中 ， 消 息 体 通 常 是 流 ， 能 够 按 各 种 方式 编码 : 来 自 表 单 的 
POST 消息 通常 是 application/x-www-form-urlencoded， 而 RESTful JSON 请 求 通常 是 
application/jsono 
所 以 说 ,Connect 程序 里 的 中 间 件 需要 对 经 过 编码 的 数据 流 进行 解码 , 包括 表单 编码 、JSON， 
甚至 是 用 gzip 或 deflate 压缩 过 的 数据 。 本 节 将 要 介绍 如 何 : 
口 处 理 表 单 输入 ; 
口 解析 JSON 请 求 ; 
口 基于 内 容 和 大 小 验证 消息 体 ; 
口 接受 文件 上 传 。 
1. 表单 
假设 要 通过 表单 接受 注册 信息 ， 你 要 做 的 只 是 把 body-parser 组 件 放 在 所 有 会 访问 req.body 
对 象 的 中 间 件 前 面 。 如 图 C1 所 示 。 







































































































































































用 户 提 交 表 单 








bodyParser 








将 表单 中 的 值 放 到 req.body 里 











继续 执行 其 他 中 间 件 











图 C-1 body-parser 对 表单 的 处 理 





下 面 是 用 body-parser 模块 处 理 来 自 表 单 的 HTTP PosT 请 求 的 代码 。 
代码 清单 C-4 解析 表单 请 求 


const connect = require('connect'); 
const bodyParser = require('body-parser'); 
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connect () 将 body-parser 
.USse (bodyParser.urlencoded({ extended: false })) 添加 到 中 间 件 栈 
.usSe((req, res, next) => { 
res.setHeader('Content-Type', 'text/plain'); 
res.end('You sent: ' + JSON.stringify (req.body) + '\n'); 以 字符 串 形式 返 
}) 回 请 求 消息 体 


.listen(3000); 


使 用 这 个 例子 需要 安装 body-parser 模块 ,还 需要 发 起 一 个 带 有 URL 编码 消息 体 的 HTTP 
请 求 。 最 简单 的 办 法 就 是 用 curl 的 选项 -da: 


curl -d name=tobi http://localhost:3000 


这 应 该 会 让 服务 咒 显 示 You sent: {"name":"tobi"}o 在 上 面 的 代码 中 ， 先是 将 body-parser 
添加 到 中 间 件 栈 中 @， 然 后 将 req.body 中 经 过 解析 的 消息 体 转换 成 字符 串 @ 以 便于 显示 。 
urlencoded 消息 体 解 析 器 可 以 接受 以 UTF-8 编码 的 字符 串 ,并 且 它 会 自动 解压 用 gzip 或 deflate 
码 的 请 求 消息 体 。 

在 这 个 例子 中 ， 传 给 消息 体 解 析 器 的 参数 是 extended: false。 当 设 为 true 时 ,消息 体 
解析 器 会 用 另外 一 个 库 解 析 查 询 字 符 串 格式 。 这 个 参数 可 以 是 更 加 复杂 的 、 舱 人 的 类 JSON 格式 
的 对 象 。 下 一 节 介 绍 请 求 的 校 验 时 会 介绍 其 他 参数 。 

2. 请 求 的 校 验 

body-parser 模块 中 的 所 有 解析 器 都 支持 两 个 请 求 校 验 参 数 : 1imit 和 verify。limit 
的 意思 是 阻止 超过 特定 大 小 的 请 求 : 默认 是 100KB ,如 果 需 要 接收 更 大 的 表单 , 可 以 修改 这 个 参 
数 。 比 如 像 内容 管 理 系统 或 博客 之 类 的 程序 ， 人 们 可 能 会 输入 很 长 的 数据 。 

verify 用 来 指定 对 请 求 进行 校 验 的 函数 。 在 需要 对 原始 的 请 求 消息 体 进行 检查 ， 比 如 要 确 
保 API 方 法 收 到 的 XML 消息 是 以 正确 的 XML 头 部 开始 的 ， 可 以 用 这 个 。 下 面 的 代码 展示 了 这 
两 个 参数 的 用 法 。 


代码 清单 C-5 ”验证 表单 请 求 


const connect = require('connect'); 
const bodyParser = require('body-parser'); 



























































潍 










































































function verifyRequest (req, res, buf, encoding) { 


if (!puf.toString() .match(/^name=/)) { 格式 不 对 时 
throw new Error('Bad format'); 抛 出 错误 
} 
} 
connect () 
.Use (bodyParser.urlencoded({ 
extended: false, 9 设 定 对 请 求 大 小 的 限制 
Trni iO, 
verify: verifyRequest 
})) é 添加 验证 函数 














@ 我们 用 的 版 本 是 1.11.0。 
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.use (function(req, res, next) { 
res.setHeader('Content-Type', 'text/plain'); 
res.end('You sent: ' + JSON.stringify (req.body) + '\n'); 


} 
.listen(3000); 


抛 出 Error 时 应 该 用 关键 字 throw@。 按照 pody-parser 模块 的 设置 ， 会 在 解析 请 求 之 
前 捕获 这 些 错误 ， 交 回 给 Connect。 在 创建 了 请 求 验证 函数 之 后 ， 需 要 用 verify 参数 传 给 
body-parser 中 间 件 组 件 全 。 

消息 体 大 小 限制 的 单位 是 字 节 ， 这 个 例子 中 设 定 的 很 小 ， 只 有 10 字 节 @@。 想 看 到 请 求 太 大 

ji 么 样 很 容易 ， 只 需要 把 前 面 那 个 curl 中 的 name 值 换 成 更 长 的 就 可 以 了 。 如 果 想 看 看 抛 
出 验证 错误 时 会 怎么 样 ， 把 curl 中 的 name 换 掉 就 可 以 了 。 

3. 为 什么 需要 LIMIT 

下 面 来 看 一 下 恶意 用 户 如 何 废 掉 一 个 脆弱 的 服务 器 。 先 创建 下 面 这 个 名 为 serverjs 的 小 型 
Connect 程序 ， 它 只 是 单纯 地 用 bodyParser () 中 间 件 解析 请 求 主体 : 


const connect = require('connect'); 
const bodyParser = require('body-parser'); 





























connect () 
.Use (bodyParser.json({ limit: 99999999, extended: false })) 
.usSe((req, res, next) => { 


res-end( "ORKN\n ); 
} 
.listen(3000); 


创建 dosjs， 代 码 如 下 所 示 。 只 需要 像 这 样 发 送 几 兆 JSON 数据 ， 恶 意 用 户 就 可 以 用 Node 
的 HTTP 客户 端 攻 击 前 面 那个 Connect 程序 了 : 
const http = require('http'); 


let reqgq = http.request({ 
method: 'POST', 





DoOrti 3000: 
headers: { 
'Content-Type': 'application/json' < 告诉 服务 器 你 
a 发 送 JSON 数据 
0 < 开交 六 关 一 个 
Se ' 大 的 数组 对 象 
while (n--) { 


} 
req.write('"bar"]'); 
req.end(); 


启动 服务 器 ， 运 行 攻击 脚本 : 


$ node server.js & 
$ node dos.js 


req.write('"foo",'); | 数组 中 包含 300 000 
个 字符 串 “foo” 
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如 果 这 时 候 用 top 监控 node 进程 ， 将 会 看 到 它 在 dosjs 启动 之 后 消耗 的 CPU 和 内 存 越 来 
越 多 。 这 很 糟糕 ， 但 好 在 Connect 提供 的 Limit 参数 可 以 防止 出 现 这 种 状况 。 

4. 解析 JSON 数据 

用 Node 做 Web 程序 时 要 处 理 大 量 的 JSON 数据 。 之 前 的 例子 中 已 经 有 一 些 使 用 JSON 解析 
器 的 示范 了 。 下 面 的 例子 演示 了 JSON 的 解析 和 结果 的 使 用 。 


代码 清单 C-6 ”解析 JSON 请 求 
const connect = require('connect'); 
const bodyParser = require('body-parser'); 























connect () 添加 JSON 消息 
.use (bodyParser.json()) 体 解 析 器 
.USe((req, res, next) => { 
res.setHeader ('Content-Type', 'application/json'); 从 body 对 象 中 
res.end(‘Name: ${req.body.name}\n.); 取 值 


}) 
.listen(3000); 
加 载 了 JSON 解析 器 后 @,， 请 求 处 理 器 不 再 把 req .body 看 作 字符 串 ， 而 是 变 成 了 一 个 JavaScript 
对 象 。 这 个 例子 假定 会 收 到 一 个 带 有 name 属性 的 JSON 对 象 , 然后 将 name 的 值 取 出 来 送 回 去 @。 
这 意味 着 请 求 的 content -Type 必须 是 application/json， 并 且 发 送 的 是 有 效 的 JSON。 默 
认 情 况 下 ，json 中 间 件 的 解析 会 很 严格 ， 但 可 以 将 这 个 设 为 false 以 降低 对 编码 的 要 求 。 



































设 定 JSON content -Type 参数 
我 们 要 知道 参数 type， 可 以 用 它 修 改 被 解析 为 JSON 的 Content -Type。 下 面 的 例子 中 
用 的 是 默认 值 ， 即 application/json。 但 有 时 候 可 能 HTTP 客户 端 不 会 发 送 这 个 消息 头 ， 
A 





可 以 用 下 面 这 个 curl 请 求 向 程序 提交 数据 ， 发 送 一 个 username 属性 的 值 为 tobi 的 JSON 
对 象 

curl -d '{"name":"tobi"}' -H "Content-Type: application/json" 

ww http://localhost:3000 

Name: tobi 

5. 解析 MULTIPART <FORM> 数据 

body-parser 模块 不 处 理 multipart 请 求 消息 体 。 但 文件 上 传 是 multipart 消息 ， 所 以 如 果 要 
支持 用 户头 像 上 传 之 类 的 功能 的 话 ， 都 需要 处 理 multipart 请 求 。 

虽然 Connect 没有 官方 支持 的 multipart 解析 器 ,但 也 能 找到 维护 得 不 错 的 模块 。 比 如 busboy 
和 multiparty, 并 且 这 两 个 都 有 相应 的 connect 模块 : connect-busboy 和 connect-multiparty。 
这 是 因为 multipart 解析 器 本 身 依赖 于 Node 的 底层 HITP 模块 ， 所 以 很 多 框架 都 可 以 使 用 ， 并 不 
是 专门 针对 Connect 做 的 。 















































286 附录 C Connect 的 官方 中 间 件 




















下 面 这 段 代 码 是 基于 multiparty 的 ， 会 在 控制 台中 输出 所 上 传 文件 的 内 容 。 
代码 清单 C-7 处 理 上 传 的 文件 


const connect = require('connect'); 
const multipart = require('connect-multiparty'); 
connect () 添加 multiparty 
.use (multipart () ) 中 间 件 
.usSe((req, res, next) => { 
console.log(reqg.files); 输出 发 送 
res.end('Upload received\n'); 的 文件 


}) 
.listen(3000); 
这 个 简短 的 例子 添加 了 multiparty 中 间 件 @ 然 后 输出 接收 到 的 文件 介 。 这 个 文件 会 被 上 
传 到 一 个 临时 位 置 上 ， 所 以 在 程序 结束 时 必须 用 久 模 块 把 它们 删 掉 。 
在 试用 这 个 例子 之 前 , 要 先 装 好 connect -multiparty", 然后 启动 服务 器 , 用 curl 的 -F 
参数 发 给 它 一 个 文件 : 
curl -PE file=@index.js http://localhost:3000 


文件 名 放 在 @ 符号 后 面 ， 前 缀 是 输入 域 的 名 称 。 这 个 输入 域 的 名 称 会 出 现在 reg .files 对 
象 里 ， 以 便于 区 分 传 上 来 的 不 同文 件 。 
程序 的 输出 应 该 会 像 下 面 这 样 。 能 得 到 rea. files.file.path, 并 且 可 以 重 命名 文件 , 将 
数据 传 给 工作 线程 处 理 ， 上 传 到 内 容 交付 网 络 ， 或 者 做 其 他 需要 做 的 事情 : 


{ fieldName: 'file', 


























originalFilename: 'index.js', 
path: '/var/folders/d0/_jqj31f96g37s5wrf79v_g4c0000gn/T/60201-p4pohc.js', 
headers: 
{ 'content-disposition': 'form-data; name="file"; filename="index.js"', 
'content-type': 'application/octet-stream' }, 


尽管 body-parser 可 以 进行 压缩 ， 但 你 可 能 还 是 想 知道 如 何 压缩 响应 。 接 下 来 我 们 会 介绍 
可 以 降低 带宽 成 本 、 提 高 体验 速度 的 compression 组 件 。 





C.1.4 _ compression: 压缩 响应 


你 可 能 注意 到 了 ， 上 一 节 介 绍 消息 体 解析 器 时 ， 它 能 解压 gzip 或 deflate 的 请 求 。Node 有 个 
处 理 压 缩 的 核心 模块 zlib， 一 般 用 于 实现 压缩 和 解压 缩 方法 。 中 间 件 compression 可 以 用 来 压 
缩 出 站 响应 ， 也 就 是 服务 需 发 送出 去 的 数据 。 

Google 的 PageSpeed Insights 工具 建议 启用 gzip 压缩 ， 你 可 以 用 浏览 器 中 的 开发 者 工具 看 一 
下 ， 会 发 现 很 多 网 站 发 送 回来 的 响应 都 是 gzip 的 。 压 缩 会 增加 CPU 的 负载 ， 但 普通 文本 和 HIML 
等 格式 的 压缩 率 很 高 ， 所 以 对 网 站 的 性 能 和 带宽 的 占用 都 会 有 明显 的 改善 作用 。 
































Q@ 我 们 测试 这 个 例子 用 的 是 1.2.5 版 。 
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Deflate 还 是 gzip 
你 可 能 不 知道 哪 种 压缩 更 好 , 其 至 不 知道 为 什么 会 有 两 种 。 从 标准 (RFC 1950 和 RFC 2616 ) 
来 看 ， 这 两 种 压缩 用 的 算法 是 一 样 的 ， 区 别 在 于 对 头 部 和 校 验 码 的 处 理 方 式 上 。 
但 有 些 浏览 器 并 不 能 正确 处 理 deflate,， 所 以 一 般 建议 用 gzip。 对 于 消息 体 解析 来 说 ， 最 好 
是 两 种 都 支持 ， 但 如 果 要 压缩 服务 器 的 输出 ， 用 gzip 比较 保险 。 








compression 模块 会 检查 消息 头 部 的 Accept-Encoding， 判 断 客户 端 能 接受 哪 种 编码 。 
如 果 消 息 头 部 没有 这 个 域 , 则 不 会 对 响应 消息 做 任何 处 理 。 如 果 有 gzip 或 aeflate, 或 者 两 个 都 
有 ， 则 压缩 啊 应 。 

1. 基本 用 法 

因为 要 封装 res .write() 和 res.end() 方 法 ， 所 以 一 般 会 把 compression 放 在 Connect 
栈 的 上 部 。 

下 面 是 对 内 容 进 行 压 缩 的 例子 : 



































const connect = require('connect'); 
const compression = require('compression'); 
connect () 
.usSe (compression({ threshold: 0 })) 
.usSe((req, res) => { 
res.setHeader('Content-Type', 'text/plain'); 


res.end('This response is compressed!\n'); 
} 
.listen(3000); 


在 运行 这 个 例子 之 前 要 先 安装 compression 模块 ， 然 后 启动 服务 器 ， 用 curl 发 送 一 个 


Accept-Encoding 为 gzip 的 请 求 : 











$ curl http://localhost:3000 -i -H "Accept-Encoding: gzip" 


参数 -i 的 意思 是 让 cURL 显示 消息 头 部 ， 所 以 你 应 该 看 到 contentEncoding 是 gzip。 
消息 主体 应 该 是 乱码 ， 因 为 压缩 过 的 数据 不 会 是 标准 的 字符 。 去 掉 -i， 把 响应 消息 通过 管道 转 给 
gunzip 应 该 能 看 到 解压 后 的 内 容 : 

$ curl http://localhost:3000 -H "Accept-Encoding: gzip" | gunzip 

这 很 强 ， 设 置 也 不 难 ， 但 并 不 是 所 有 从 服务 器 发 出 来 的 东西 都 需要 压缩 ， 可 以 用 定制 的 
filter 羡 数 跳 过 某 些 内 容 。 

2. 使 用 定制 的 filter 函数 

compression 在 默认 的 filter 国 数 中 包含 了 MIME 类 型 cext/*、*/json 和 */javascript,， 
所 以 只 会 压缩 这 些 响应 数据 : 


exports.filter = function(req, res)t{ 
const type = res.getHeader('Content-Type') || '!' 
return type.match(/json|ltext|javascript/); 


ja 
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要 改变 这 种 行为 ， 可 以 给 选项 对 象 传人 定制 的 filter 函数 ， 代 码 如 下 所 示 : 


function filter(req) { 
const type = req.getHeader('Content-Type') || '' 
return 0 === type.indexOf ('text/plain'); 

} 

connect () 
.Use (compression({ filter: filter })); 


ee 


这 样 只 会 压缩 普通 文本 。 
3. 指定 压缩 和 内 存 水 平 
Node 的 zlib 的 性 能 和 压缩 特性 是 可 以 通过 参数 调节 的 ， 把 参数 传 给 compression 函数 就 行 。 
在 下 面 这 个 例子 中 ， 压 缩 level 被 设 为 3， 压缩 率 低 ， 但 速度 快 ; memLevel 被 设 为 8， 使 
用 更 多 内 存 以 加 快 压缩 速度 。 给 这 些 参数 取 什么 值 完全 取决 于 程序 本 身 及 可 用 的 资源 。Node 的 
zlib 文档 里 有 更 详细 的 介绍 。 


connect () 
.uUSe (compression({ level: 3, memLevel: 8 })); 


好 了 ， 接 下 来 我 们 要 看 看 覆盖 Web 程序 核心 需求 的 中 间 件 ， 比 如 日 志和 会 话 。 


C.2 ”实现 Web 程序 核心 功能 的 中 间 件 


Connect 要 为 大 多 数 常 见 的 Web 程序 需求 提供 中 间 件 ， 这 样 开发 人 员 就 不 用 一 次 次 地 重新 
实现 它们 了 。 在 Connect 中 , 像 日 志 、 会 话 和 虚拟 主机 这 些 Web 程序 的 核心 功能 都 有 自 带 的 中 
间 件 。 

本 节 会 介绍 五 个 非常 实用 的 中 间 件 ， 你 很 可 能 会 在 自己 的 程序 中 用 到 它们 : 
提供 灵活 的 请 求 日 志 ; 

人 处理 /favicon.ico 请 求 ; 

D method-override 让 没有 能 力 的 客户 端 透 明 地 重 写 req .method; 
口 vhost 一 一 在 一 个 服务 右上 设置 多 个 网 站 ( 虚拟 主机 ); 

D express-session 管理 会 话 数 据 。 


之 前 你 创建 过 自己 的 日 志 中 间 件 , 但 Connect 提供 了 更 灵活 的 morgan, 我 们 先 来 了 解 一 下 吧 。 


















































D morgan 





D serve-favicon 
































C.2.1 morgan: 记录 请 求 


morgan 是 一 个 灵活 的 请 求 日 志 中 间 件 ， 可 定制 日 志 格 式 。 还 能 通过 参数 调节 日 志 输 出 缓冲 
区 以 减少 写 硬盘 的 次 数 。 另 外 ， 如 果 你 想 把 日 志 输 出 到 控制 台 之 外 的 其 他 地 方 ， 比 如 文件 或 socket 
中 ， 还 可 以 指定 日 志 流 。 

1. 基本 用 法 

morgan 模块 的 用 法 如 下 所 示 ， 调 用 函数 让 它 返回 一 个 中 间 件 函数 。 
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代码 清单 C-8 使 用 morgan 模块 记录 日 志 


const connect = require('connect'); 
const morgan = require('morgan'); 


connect () 给 所 有 请 求 用 “combined” 
.Use (morgan('combined')) 志 
.usSe((req, res) => { 
res.setHeader('Content-Type', 'application/json'); 
res.end('Logging\n'); 用 消息 响应 
请 求 


.listen(3000); 


运行 这 个 例子 之 前 要 先 安装 morgan。 我 们 把 这 个 模块 放 在 了 中 间 件 栈 的 最 顶端 @, 然后 输 
出 了 一 条 简单 的 响应 消息 介 。combined 是 指定 日 志 格 式 的 参数 @， 表 示 这 个 Connect 程序 会 按 
照 Apache 格式 输出 日 志 。 这 种 格式 很 灵活 ， 很 多 命令 行 工具 都 能 解析 ， 所 以 可 以 用 日 志 处 理 程 
序 生成 统计 数据 。 如 果 想 通过 不 同 的 客户 端 ( 比如 curl、wget 和 浏览 器 ) 发 送 请 求 ， 应 该 看 一 
下 日 志 中 的 用 户 代理 字段 。 

combined 的 日 志 格 式 如 下 所 示 : 


:remote-addr - :remote-user [:date[clf]] ":method :url 
加 HTTP/:http-version" :status :res[content-length] ":referrer" ":user-agent" 


每 个 :something 都 是 一 些 信 令 , 在 真正 的 日 志 记 录 中 它们 包含 的 是 来 自 HTTP 请 求 的 真实 
值 。 比 如 说 ， 一 个 简单 的 curl (1) 请 求 会 生成 下 面 这 样 一 条 日 志 : 
127.0.0.1 - - [Thu, 05 Feb 2015 04:27:07 GMT] 


wh EEE .HLTTP/AL L200 =" 
Lt lb lh od yA me A A 


















































2. 定制 日 志 格 式 
日 志 的 格式 可 以 通过 传人 一 个 信 令 字符 串 来 进行 定制 。 比 如 下 面 这 种 格式 会 输出 GE 
/users 15 ms 格式 的 日 志 : 


connect () 
-Use (morgan(':method :url :response-time ms')) 
.use (hello) 
.listen(3000); 


默认 可 以 使 用 下 面 这 些 信 令 (注意 ， 头 名 称 对 大 小 写 不 敏感 ): 
口 :x*eq[ 头 名 称 ] 比如 : :req[Accept] 
:res[ 头 名 称 ] 比如 : :res [Content-Length ] 























LE 
| 


:http-version 
:response-time 
:remote-addr 
:date 

:method 





DOOODODO 











我 们 用 的 是 1.5.1 版 。 
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Eb a 
:referrer 


:USer-agent 





DODODO 


:Status 


定义 定制 的 信 令 也 不 难 。 只 需要 给 connect .1ogger .token 铺 数 提供 信 令 名 称 和 回调 函数 
就 行 。 比 如 说 ， 你 想 记 录 所 有 i 0 符 ， 可 以 这 样 定 义 它 : 

Var url = require('url'); 

morgan.token('gquery-string', function(req, res)t 


return url.parse(req.url) .gquery; 


jy) 


除了 默认 的 格式 ，morgan 还 有 其 他 预定 义 的 格式 ， 比 如 short 和 tiny。 男 一 个 预定 义 的 
格式 是 dev, 其 可 以 为 开发 输出 简洁 的 日 志 , 适用 于 那 种 只 有 你 一 个 人 在 网 站 上 ,并 且 不 关心 HTTP 
请 求 细节 时 的 情况 。 这 个 格式 还 会 根据 响应 状态 码 设置 不 同 的 颜色 : 200 是 绿色 ，300 是 蓝 色 ， 

400 是 黄色 ，500 是 红色 。 这 种 颜色 划分 对 开发 很 有 帮助 。 
要 使 用 预定 义 的 格式 ， 只 需要 把 名 字 传 给 morgan (): 
connect () 

.use (morgan('dev')) 


.use (hello); 
.listen(3000); 


你 已 经 知道 如 何 格式 化 morgan 的 输出 了 ， 接 下 来 看 看 你 能 提供 哪些 选项 给 它 。 

3. 日 志 选 项 : stream 和 immediate 

如 前 所 述 ， 你 可 以 用 选项 调整 morgan 的 行为 。 

stream 就 是 这 样 的 选项 ， 你 可 以 给 morgan 传递 一 个 Node Stream 实例 来 代替 stdout， 让 
它 把 日 志 写 到 这 个 stream 实例 中 。 这 样 你 可 以 用 fs .createwWriteStream 创建 一 个 Stream 
实例 ， 把 日 志 输 出 到 独立 的 日 志文 件 中 ， 脱 离开 服务 器 自己 的 输出 。 

在 使 用 这 些 选项 时 , 通常 应 该 包括 format 属性 。 下 面 这 个 例子 使 用 了 定制 的 格式 , 将 日 志 
输出 到 /var/log/myapp.log 中 ， 因 为 有 追加 标记 ， 所 以 在 程序 启动 时 日 志文 件 不 会 被 截断 : 

const fs = require('fs")y 


const morgan = require('morgan'); 
const log = fs.createWriteStream('/var/log/myapp.log', { flags: 'a' }) 
connect () 

.Use (morgan({ format: ':method :url', stream: log })) 

.usSe('/error', error) 

.use (hello) 

.listen(3000); 







































































immediate 是 另 一 个 常用 的 选项 ， 使 用 这 个 选项 时 ， 一 收 到 请 求 就 写 日 志 ， 而 不 是 等 到 响 
应 后 才 写 。 如 果 服 务 器 保持 请 求 长 开 , 并 且 你 想 知道 连接 什么 时 候 开 始 ， 就 可 以 用 这 个 选项 。 或 
者 用 它 来 调试 程序 中 的 关键 部 分 。 不 能 使 用 :status 和 :response-time 之 类 的 信 令 ,因为 它 
们 是 跟 响应 相关 的 。 要 启用 即刻 模式 ， 可 以 传人 取 值 为 true 的 immediate， 代 码 如 下 所 示 : 
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const app = connect () 
.Use(connect .logger({ immediate: true })) 
.USe('/error', error) 
.use (hello); 


这 就 是 日 志 记 录 ! 接 下 来 我 们 去 看 看 serve-favicon 中 间 件 。 




















C.2.2 serve-favicon: 地 址 栏 和 书签 图 标 


favicon 是 网 站 的 小 图 标 ， 显 示 在 浏览 器 的 地 址 栏 和 书签 里 。 为 了 得 到 这 个 图 标 ， 浏 览 器 会 
请 求 /favicon.ico 文件 。 一 般 来 说 ， 最 好 尽快 响应 对 favicon 文件 的 请 求 ， 这 样 程序 的 其 他 部 分 就 
可 以 忽略 它们 了 。serve-favicon 中 间 件 默认 会 返回 Connect 的 favicon( 当 没 有 参数 传 给 它 时 )。 
这 个 favicon 如 图 C-2 所 示 。 











OIC $local a WW 
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Hello World! 





图 C-2 favicon 


基本 用 法 

serve-favicon 一 般 放 在 中 间 件 栈 的 最 项 端 ， 所 以 连 下 面 的 日 志 组 件 都 会 忽略 对 favicon 
的 请 求 。 然 后 这 个 图 标 就 会 缓存 在 内 存 中 ， 可 以 更 快 地 响应 后 续 请 求 。 

下 面 这 个 例子 给 serve-favicon 传人 了 一 个 参数 ， 这 是 一 个 .ico 文件 的 路 径 ， 从 而 用 这 
个 .ico 文 件 响应 对 favicon 文件 的 请 求 : 


const connect 
const favicon 























require('connect'); 
require('serve-favicon'); 


connect () 
.use(favicon(_ dirname + '/favicon.ico')) 
.usSe((req, res) => { 


res.end('Hello World!\n'); 
}) 妆 


要 测试 这 上段 代码 需要 准备 一 个 favicon.ico 文件 。 此 外 , 还 可 以 传人 一 个 maxAge 参数 ,指明 
浏览 如 应 该 把 favicon 放 在 内 存 中 缓存 多 长 时 间 。 
接 下 来 我 们 还 有 一 个 小 而 实用 的 中 间 件 : method-override。 当 客户 端 能 力 有 限时 ， 它 可 
以 提供 一 种 方案 ， 用 于 伪造 HTTP 请 求 方法 。 








C.2.3 method-override: 伪造 HTTP 方法 


有 时 需要 使 用 GET 或 PosT 之 外 的 HTTP 谓词 。 比 如 要 搭建 一 个 博客 系统 ， 想 让 用 户 创建 、 
更 新 和 删除 文章 。 使 用 DELETE /articles 感觉 比 用 GET 或 PosT 更 好 ， 可 惜 并 不 是 所 有 浏览 器 都 
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支持 DELETE。 

一 种 常见 的 解决 办 法 是 通过 请 求 参数 、 表 单 值 , 有 时 甚至 是 HTTP 请 求 头 来 提示 服务 器 用 的 
是 哪个 HITP 方法 。 比 如 添加 一 个 <input type=hiddqen>， 将 其 值 设 定 为 你 想 用 的 方法 名 ， 然 
后 让 服务 器 检查 那个 值 并 “假装 ” 它 是 这 个 请 求 的 请 求 方法 。 

很 多 Web 框架 都 支持 这 种 技术 ，Connect 推荐 使 用 method-overrige 模块 。 

1. 基本 用 法 

HTML 输入 控件 默认 的 名 称 是 _ method， 不 过 可 以 给 methoqoverriaqe () 传 人 一 个 参数 来 
定制 它 ， 代 码 如 下 所 示 : 
































connect () 
const connect = require('connect'); 
const methodOverride = require('method-override'); 
connect () 
.Use (methodOverride('_ method _')) 
.listen(3000) 

















为 了 阐明 methodoverrige() 是 如 何 实现 的 ， 我们 来 创建 一 个 更 新 用 户 信 息 的 微型 程序 。 


这 个 程序 中 会 有 一 个 表单 ， 当 表单 经 浏览 絮 提 交 并 被 服务 器 处 理 后 , 会 用 一 个 简单 的 成 功 消息 做 
响应 ， 如 图 C-3 所 示 。 











a © © locall 站 @s| 











em 
茸 C [© tocall 人 8&E@ a 














图 C-3 用 methogdoverrigde() 模 拟 PUT 请求 ， 更 新 浏览 器 中 的 表单 


这 个 程序 用 两 个 中 间 件 更 新 用 户 数据 。 在 update 函数 中 ， 如 果 请 求 方法 不 是 PoT， 就 调用 
next ()。 就 像 前 面 说 过 的 ， 大 多 数 浏 览 占 都 会 无 视 表 单 属性 method="put"， 所 以 下 面 这 段 代 
码 不 能 正常 工作 。 


代码 清单 C-9 不 可 用 的 用 户 更 新 程序 


const connect = require('connect'); 














const morgan = require('morgan'); 
const bodyParser = require('body-parser'); 
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function edqit (eaG，Les，mnext) { 
if ('GET' != req.method) return next(); 
res.setHeader('Content-Type', 'text/html'); 
res.write('<form method="put">'); 
res.write('<input type="text" name="user [name]" value="Tobi" />'); 
res.write('<input type="submit" value="Update" />'); 
( 





res.write('</form>'); 发 送 PUT 而 不 是 

res.end(); GET 或 PosT 方 
} 法 的 表单 
function update(req, res, next) { 

if ('PUT' != req.method) return next(); 

=| 

res.end('Updated name to ' + req.body.user.name); 确保 请 求 是 用 
} PUT 发 送 的 
connect () 


.Use (morgan('combined')) 
.USe (bodyParser.urlencoded({ extended: false })) 
.use (edit) 
.use (update) 
.listen(3000); 


这 个 例子 中 的 表单 要 发 送 一 个 PUT 给 服务 器 @。 并 有 旦 只 有 通过 PUT 发 送 时 ， 表 单 的 数据 才 
会 给 update 函数 @, 你 可 以 用 不 同 的 浏览 器 和 HTTP 客户 端 试 一 下 。 使 用 curl 时 , 可 以 用 -x 
选项 指定 HTTP 谓词 。 

可 以 添加 method-override 模块 来 改善 对 浏览 器 的 文 持 。 这 里 在 表单 中 加 了 一 个 名 为 
_methoa 的 输入 控件 ， 并 且 在 bodyParser () 下 面 加 上 了 methodoverriqde()， 因 为 它 要 引用 
req.body 访问 表单 数据 。 


代码 清单 C-10 使 用 method-overrige 支持 HTTP PUT 


const connect = require('connect'); 

const morgan = require('morgan'); 

const bodyParser = require('body-parser'); 

const methodOverride = require('method-override'); 








function edit (req, res, next) { 通过 表单 变量 
if ('GET' != req.method) return next(); _method 来 提示 
res.setHeader('Content-Type', 'text/html'); HTTP 方法 
res.write('<form method="post">'); 


'<input type="hidden" name="_method" value="put" />'); < 一 一 
'<input type="text" name="user [name]" value="Tobi" />'); 

'<input type="submit" value="Update" />'); 

人 这 


res.write 
res.write 
res.write 
res.write 
res.end(); 


( 
( 
( 
( 


function update(req, res, next) { 
if ('PUT' != req.method) return next(); 
res.end('Updated name to S${req.body.user.name}');; 
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connect () 
.Use (morgan('dev')) 
.use (bodyParser.urlencoded({ extended: false })) 


( 
.Use (methodOverride('_method')) < 用 methodoverride 
.use (edit) 中 间 件 组 件 检 查 表单 
.use (update) 亦 晶 


.listen(3000); 
现在 你 会 发 现 几乎 所 有 的 浏览 器 都 可 以 发 送 PUT 请 求 了 。 
2. 访问 原始 的 rega.method 
methodoverride() 修 改 了 原始 的 red.method 属性 , 但 Connect 留 了 一 份 副本 ， 随 时 可 以 通 
过 req.originalMethod 得 到 原始 值 。 也 就 是 说 对 于 前 面 那个 表单 而 言 ， 可 以 输出 下 面 这 样 的 值 : 


console.log(req.method); 























区 BO 
console.log(regq.originalMethod); 
A POSTY 


如 果 不 想 引 入 额外 的 表单 变量 , 也 可 以 用 HTTP 消息 头 部 域 。 因 为 不 同 的 厂商 所 用 的 头 部 域 
也 不 同 , 所 以 要 让 服务 器 支持 多 种 头 部 域 。 有 些 客户 端 工 具 和 库 也 会 发 送 特定 的 头 部 域 。 下 面 这 
个 例子 支持 三 种 头 部 域 : 

app.use (methodOverride('X-HTTP-Method')) < 一 一 一 Microsoft 


app.use (methodOverride('X-HTTP-Method-Override')) Google/GData 
app.use (methodqovertride ('X-Methodq-Overtide') ) IBM 


基于 头 部 域 的 路 由 是 常规 任务 。 对 虚拟 主机 的 支持 就 是 这 么 做 的 。 想 用 少量 IP 地 址 支持 多 
个 网 站 时 ，Apache 服务 器 就 会 使 用 虚拟 主机 。Apache 和 Nginx 会 根据 头 部 域 Host 来 决定 访问 的 
是 哪个 网 站 。 

Connect 也 可 以 ， 而 且 会 比 你 想象 得 简单 。 接 下 来 我 们 介绍 vhost 模块 和 虚拟 主机 。 



































C.2.4 vhost: 虚拟 主机 


vhost ( 虚拟 主机 ) 模块 是 一 种 通过 请 求 头 Host 路 由 请 求 的 中 间 件 组 件 。 这 项 任务 通常 是 由 
反 向 代理 完成 的 ， 然 后 把 请 求 转发 到 运行 在 不 同 端口 上 的 本 地 服务 器 那里 。 使 用 vhost 组 件 , 可 以 
在 同一 个 Node 进程 中 完成 这 一 操作 , 它 可 以 将 控制 权 交 给 跟 vhost 实例 关联 的 Node HTTP 服务 器 。 

1. 基本 用 法 

跟 大 多 数 中 间 件 一 样 ， 一 行 代码 就 可 以 把 vhost 跑 起 来 。 它 有 两 个 参数 : 第 一 个 是 主机 名 ， 
vhost 实例 会 用 它 进行 匹配 。 第 二 个 是 http .Server 实例 , 用 来 处 理 对 相 匹 配 的 主机 名 发 起 的 
HTTP 请 求 (Connect 程序 都 是 httpb.servez 的 子 类 ， 所 以 程序 实例 可 以 胜任 这 项 工作 ): 

const connect = require('connect'); 

const server = connect () ; 

const vhost = require('vhost'); 

const app = require('./sites/expressjs.dev'); 


server.use(vhost ('expressjs.dev', app)); 
server.listen(3000); 
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为 了 能 用 前 面 那 个 ./sites/expressjs.dev 模块 ， 它 应 该 像 下 面 这 个 例子 这 样 ， 把 HTTP 服务 器 
赋 给 modqaule.exports: 


const http = require('http') 

module.exports = http.createServer((req, res) => { 
res.end('hello from expressjs.com\n'); 

je 


2. 使 用 多 个 vhost 实例 
跟 其 他 中 间 件 一 样 ， 在 一 个 程序 中 可 以 多 次 使 用 vhost， 将 几 个 主机 关联 到 它们 的 程序 上 : 


const app = require('./sites/expressjs.dev'); 
server.use(vhost ('expressjs.dev', app)); 
const app = require('./sites/learnboost.dev'); 
server.use(vhost('learnboost.dev', app)); 


也 可 以 不 这 样 手动 设置 vnost， 而 是 从 文件 系统 中 生成 一 个 主机 列表 。 具 体 做 法 如 下 例 所 示 ， 
用 fs.readdirsync() 方 法 返回 一 个 日 录 实 体 的 数组 : 


const connect = require('connect') 
const fs = require('fs'); 
cons app = connect() 
const sites = fs.readdirSync('source/sites'); 
sites.forEach((site) => { 
console.log(' 4 
app.use(vhost (site, require('./sites/' + site))); 




















app.listen(3000); 


vhost 用 起 来 比 反 向 代理 简单 。 可 以 把 所 有 程序 作为 一 个 单元 管理 。 对 于 一 些小 网 站 , 或 者 
大 部 分 由 静态 内 容 构 成 的 网 站 来 说 ， 这 种 方式 很 理想 。 但 它 也 有 缺点 ， 如 果 一 个 网 站 引发 了 月 浊 ， 
你 的 所 有 网 站 都 会 宕 掉 ( 因为 它们 都 运行 在 同一 个 进程 中 )。 

接 下 来 我 们 要 看 一 个 最 基础 的 Connect 中 间 件 : 会 话 管理 组 件 express-session。 


























C.2.5 express-session: 会 话 管理 


Web 程序 处 理会 话 的 方式 取决 于 变化 的 需求 。 比 如 后 端 存 储 的 选择 : 有 些 程序 为 了 性 能 使 用 
Redis 这 样 的 高 性 能 数据 库 ; 有 些 为 了 简单 使 用 跟 主 程序 一 样 的 数据 库 。express-session 模 
块 提供 了 可 以 通过 扩展 适用 不 同 数据 库 的 API， 所 以 它 的 扩展 模块 很 多 。 本 节 将 会 介绍 如 何 使 用 
基于 内 存 和 Redis 的 模块 。 

我 们 先 把 中 间 件 设置 起 来 ， 并 探索 一 下 它 有 哪些 选项 可 用 。 

1. 基本 用 法 

代码 清单 C-11 实现 了 一 个 最 简 配 置 的 页 面 浏 览 计 数 程序 ， 数 据 存在 用 户 会 话 中 。 默 认 的 会 
话 cookie 名 是 connect .sid, 并 且 被 设 定 为 bttponly， 也 就 是 说 客户 端 脚本 不 能 访问 它 的 值 。 
在 服务 器 端 , 会 话 数据 是 放 在 内 存 里 的 。 下 面 的 代码 是 express-session 在 Connect 中 的 基本 
用 法 。” 






























































中 用 1.10.2 版 本 的 express-session 做 的 测试 。 
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代码 清单 C-11 在 Connect 中 使 用 会 话 


const connect 
const session 


require('connect'); 
require('express-session'); 


connect () 
.use (session({ 这 是 使 用 会 话 
secret: 'example secret', 的 基本 选项 


resave: false, 
saveUninitialized: true 


} 


.use((req, res) => { 设置 会 话 变量 “views”， 
req.session.views = req.session.views || 0; 每 次 访问 加 1 
req.session.viewst+t+; < 二 
res.end('Views:' + req.session.views); < 一] 把 结果 值 送 回 

}) 给 浏览 器 


.listen(3000); 


这 个 小 例子 配置 好 了 会 话 ， 并 对 一 个 名 为 views 的 会 话 变量 进行 操作 。 先 是 用 必需 的 选项 
初始 化 会 话 中 间 件 , 这 些 选 项 包括 : secret、resave 和 saveUninitialized@, 选项 secret 
决定 了 是 否 对 识别 会 话 用 的 cookie 进行 签名 。resave 迫使 所 有 请 求 都 要 保存 会 话 ， 即 便 它 没有 
变化 也 要 保存 。 有 些 会 话 存 储 后 台 需 要 这 个 选项 ， 所 以 在 启用 它 之 前 ,要 先 检 查 一 下 。 最 后 一 个 
选项 ，saveuninitialized， 表 示 即 便 没 有 要 保存 的 值 也 要 创建 会 话 。 如 果 想 遵循 保存 cookie 
之 前 先 征求 用 户 同 意 的 法 则 ， 可 以 把 这 个 关 掉 。 

2. 设 定 会 话 有 效 期 

假定 你 想 让 会 话 在 24 小 时 后 过 期 ， 只 在 使 用 HITPS 时 才 发 送 会 话 cookie， 并 日 要 配置 cookie 
的 名 称 。 在 req.session 对 象 上 设 定 expries 或 maxAge 可 以 控制 会 话 持 续 多 长 时 间 


const hour = 3600000 
regq.session.cookie.expires = new Date(Date.now() + hour * 24);，; 
req.session.cookie.maxAge = hour * 24; 


使 用 Connect 时 经 常 要 设 定 maxage， 以 毫秒 为 单位 指定 从 那 一 时 点 开始 的 时 长 。 这 种 表示 
未 来 时 间 的 表达 方法 通常 更 直观 ， 本 质 上 等 同 于 new Date(Date. now() + maxAge)。 

会 话 设置 好 了 ， 接 下 来 我 们 来 看 一 下 处 理会 话 数据 时 的 方法 和 属性 。 

3. 处 理会 话 数据 

express-session 的 数据 管理 API 非常 简单 。 其 基本 原理 是 当 请 求 完 成 时 , 赋 给 req.session 
对 象 的 所 有 属性 都 会 被 保存 下 来 。 然 后 当 相 同 的 用 户 〈 浏 览 器 ) 再 次 发 来 请 求 时 ， 会 加 载 它们 。 
比如 说 ， 保 存 购物 车 信息 就 像 将 一 个 对 象 赋 给 cart 属性 那么 简单 ， 如 下 所 示 : 


req.session.cart = { items: [1,2,3] }; 


在 后 续 的 请 求 中 访问 req.session.cart 时 ， 就 可 以 得 到 .items 数组 。 因 为 这 是 个 常规 
的 JavaScript 对 象 ， 所 以 可 以 在 后 续 的 请 求 中 调用 这 个 对 和 对象 上 的 方法 ， 就 像 下 面 这 个 例子 中 
这 样 ， 并 且 它 们 能 像 你 期 望 的 那样 保存 下 来 : 


req.session.cart.items.push(4); 
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在 使 用 会 话 对 象 时 ， 有 一 点 一 定 要 记 住 ， 会 话 对 象 在 各 个 请 求 间 会 被 串 行 化 为 ISON 对 象 ， 
所 以 req.session 对 象 有 跟 JSON 一 样 的 局 限 性 : 不 允许 循环 属性 ， 不 能 用 function 对 象 ， 
Date 对 象 无 法 正确 串 行 化 ， 等 等 。 在 使 用 会 话 对 象 时 ， 一 定 要 记 住 这 些 限 制 。 

Connect 会 自动 保存 会 话 数据 , 但 它 内 部 是 通过 调用 session#save ( [callback] ) 方 法 完成 的 ， 
这 是 一 个 公开 的 API。 此 外 还 有 两 个 辅助 方法 ，Session#destroy() 和 Session#regenerate()， 
在 对 用 户 进行 认证 以 防止 会 话 固定 攻击 时 经 常用 到 它们 。 在 用 Express 构建 程序 时 ， 要 用 这 些 方 
法 实现 用 户 认证 。 

接 下 来 我 们 介绍 会 话 cookie。 

4. 操纵 会 话 cookie 

Connect 允许 你 为 会 话 提 供 全 局 cookie 设 定 ， 但 也 可 以 通过 session#cookie 操纵 特定 的 
cookie， 它 默认 是 全 局 设 定 。 

在 调整 那些 属性 之 前 , 我 们 先 把 前 面 那 个 会 话 程序 扩展 一 下 , 把 所 有 属性 都 写 人 响应 HTML 
中 的 单个 <p> 标 记 中 ， 看 看 这 些 会 话 cookie 的 属性 ， 如 下 所 示 : 

























































































res.write('<p>views: ' + sess.views + '</p>'); 

res.write('<p>expires in: ' + (sess.cookie.maxAge / 1000) + 's</p>'); 
res.write('<p>httpOnly: ' + sess.cookie.httpOnly + '</p>'); 
res.write('<p>path: ' + sess.cookie.path + '</p>'); 
res.write('<p>domain: ' + Sess.cookie.domain + '</p>'); 
res.write('<p>secure: ' + Sess.cookie.secure + '</p>'); 





在 express-session 中 ， cookie 的 所 有 属性 ， 比如 expires、 httpOnly、 secure, path 
和 domain， 都 可 以 针对 每 个 会 话 进行 程序 性 修改 。 比 如 说 ， 你 可 以 像 下 面 这 样 让 一 个 活动 的 会 
话 在 5 秒 内 失效 : 

req.session.cookie.expires = new Date(Date.now() + 5000); 

设置 过 期 时 间 的 另 一 本 API 是 .maxage 访问 吉 ， 可 以 按 毫 秒 获取 和 设 定 相对 当前 
时 间 的 时 间 值 。 下 面 这 段 代码 也 会 让 会 话 在 5 秒 内 过 期 : 


req.session.cookie.maxAge = 5000; 


剩 下 的 属性 ，domain、path 和 secure， 限 定 了 cookie 的 作用 域 ， 按 域名 、 路 径 或 安全 连 
接 来 限定 它 ， 而 httponly 可 以 防止 客户 端 脚本 访问 cookie 数据 。 这 些 属性 都 可 以 按 相 同 的 方 
式 操纵 : 


req.session.cookie.path = '/admin'; 
req.session.cookie.httpOnly = false; 


之 前 你 一 直 在 用 默认 的 内 存 存 储 保存 会 话 数据 , 接 下 来 我 们 要 看 看 如 何 插入 其 他 的 会 话 数 据 
Rs 
会 话 存储 
ee MemoryStore 是 一 种 简单 的 内 存 数据 存储 ， 非 常 适合 运行 程序 测试 ， 因 为 它 不 需要 




































































298 附录 C Connect 的 官方 中 间 件 





其 他 依赖 项 。 但 在 开发 和 生产 期 间 ， 最 好 有 一 个 持久 化 的 、 可 扩展 的 数据 库存 放 你 的 会 话 数据 ， 
否则 服务 器 一 重启 这 些 数据 就 于 了 。 
虽然 任何 数据 库 都 可 以 做 会 话 存储 ， 但 低 延 迟 的 键 / 值 存储 最 适合 这 种 易 失 性 数据 。Connect 
社区 已 经 创建 了 几 个 使 用 数据 库 的 会 话 存储 ， 包 括 CouchDB 、MongoDB 、Redis 、Memcached、 
PostgreSQL 等 。 

我 们 以 Redis 和 connect-redis 模块 为 例 介绍 一 下 如 何 将 会 话 数据 存储 在 数据 库 中 。Redis 支持 
键 的 有 效 期 ， 性 能 很 好 ， 并 且 易 于 安装 ， 所 以 很 适合 用 来 支持 会 话 数 据 的 存储 。 

运行 redis-server， 以 确保 已 经 安装 过 Redis 本: 


$ redis-server 

[11790] 16 Oct 16:11:54 * Server started, Redis version 2.0.4 

[11790] 16 Oct 16:11:54 * DB loaded from disk: 0 seconds 

[11790] 16 Oct 16:11:54 * The server is now ready to accept 

ww connections on port 6379 

[11790] 16 Oct 16:11:55 - DB 0: 522 keys (0 volatile) in 1536 slots HT. 


接 下 来 ， 把 connect-redis 添加 到 package.json 文件 中 ， 运 行 npm install 安装 它 , 或 者 直 
接 执行 npm install --save connect-redis。"connect-redis 模块 提供 了 一 个 函数 ， 需 要 一 
个 express-session 的 实例 做 参数 ， 代 码 如 下 所 示 。 


代码 清单 C-12 ”使 用 Redis 作为 会 话 存储 








邢 
































const connect = require('connect'); 
const session = require('express-session'); 
const RedisStore = require('connect-redis') (session); 3 将 express- eegisu 的 
const favicon = require('serve-favicon'); 

| reel 实例 传 给 Reaisstore 
Const Options = { 


host: 'localhost' 
站 


connect ( ) 
.Use(favicon( dirname + '/favicon.ico')) 
.use (session({ 
store: new RedisStore(options), 


用 默认 选项 和 Redisstore 
secret: 'keyboard cat', 








配置 session 
resave: false, 
saveUninitialized: true 
})) 
.usSe((req, res) => { 
req.session.views = req.session.views || 0; S 
ee session.views Bb | 会 话 值 的 
5 lOn.viewst+t+; Hd 
2 A ， ， 常规 方式 
res.end('Views: + req.session.views); 


}) 
.listen(3000); 


这 个 例子 配置 了 一 个 使 用 Redis 的 会 话 存储 。 将 express-session 引用 传 给 connect-redis， 
以 允许 它 继承 session.Store.prototype。 因为 在 Node 中 , 一 个 进程 里 可 能 会 同时 使 用 多 个 




















@ 写作 本 书 时 用 的 是 2.2.0 版 。 
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版 本 的 模块 , 所 以 这 很 重要 。 把 指定 版 本 的 express-session 传 给 它 可 以 确保 connect-redis 用 
的 是 正确 的 副本 。 

RedisStore 作为 store 的 值 传 给 了 session() ， 你 想 用 的 所 有 选项 ， 比 如 会 话 用 的 键 前 
级 ,都 可 以 传 给 Redisstore 构造 器 。 做 完 这 两 步 后 ,可 以 像 使 用 Memorystore 时 那样 访问 会 
话 变量 。 这 个 例子 中 有 个 小 细节 需要 注意 一 下 , 在 session 上 面 有 个 中 间 件 组 件 favicon, 我 们 把 它 
放 在 那里 是 为 了 防止 每 次 访问 会 让 views 加 2， 因 为 浏览 器 每 次 获取 页 面 时 都 会 请 求 /favicon .ico。 

哎呀 ! 讨论 了 这 么 多 跟 会 话 有 关 的 内 容 ， 终 于 把 核心 概念 中 间 件 全 部 介绍 了 。 接 下 来 我 们 要 
讨论 处 理 Web 程序 安全 的 内 置 中 间 件 。 对 于 需要 保证 数据 安全 的 程序 来 说 ， 这 是 一 个 非常 重要 的 
主题 。 


C.3 处理 Web 程序 安全 的 中 间 件 


我 们 已 经 说 过 很 多 次 了 ，Node 的 核心 API 刻意 停留 在 底层 。 也 就 是 说 它 没有 为 构建 Web 程 
序 提供 内 置 的 安全 或 最 佳 实践 。 好 在 Connect 中 间 件 组 件 实现 了 这 些 安全 实践 。 
本 节 会 介绍 三 个 与 安全 有 关 的 模块 ， 可 以 用 npm 安装 : 
D pasic-auth 一 一 为 保护 数据 提供 了 HTTP 基本 认证 ; 
实现 对 跨 站 请 求 伪 造 (CSRF ) 攻击 的 防护 ; 
口 errorhandler 一 一 帮 你 在 开发 过 程 中 进行 调试 。 
我 们 先 来 看 看 实现 了 HTTP 基本 认证 ， 对 程序 中 的 受 限 区 域 进行 保护 的 basic-auth。 





















































口 csurf 














C.3.1 basic-auth: HTTP 基本 认证 


在 第 4 章 ， 你 创建 了 一 个 简陋 的 基本 认证 中 间 件 组 件 。 好 吧 ， 实 际 上 有 好 几 个 Connect 模块 
都 可 以 干 这 个 。 如 前 所 述 ， 基 本 认证 是 非常 简单 的 HTTP 认证 机 制 ， 并 且 在 使 用 时 应 该 小 心 ， 因 
为 如 果 不 是 通过 HTTPS 进行 认证 ， 用 户 凭证 很 可 能 会 被 攻击 者 截获 。 不 过 可 以 用 它 给 小 型 或 个 
人 的 程序 添加 一 个 简单 粗 陋 的 认证 方式 。 

如 果 你 的 程序 用 了 basic-auth 组 件 ， 浏览 器 会 在 用 户 第 一 次 连接 程序 时 提示 用 户 输入 赁 
证 ， 如 图 C-4 所 示 。 
























































The server local:80 requires a username and password. 
The server says: Authorization Required. 


User Name' 





Password: 


(Cancel Log In ) 


图 C-4 基本 认证 提示 框 





1. 基本 用 法 
pbasic-auth 模块 提供 了 从 HTTP 请 求 消息 头 部 域 Authorization 中 获取 凭证 的 方法 。 下 
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面 是 通过 basic-auth 使 用 自己 的 密码 验证 函数 进行 认证 的 示例 代码 。 
代码 清单 C-13 ”使 用 basic-auth 模块 


const auth = require('basic-auth'); 
const connect = require('connect'); 


function passwordValid(credentials) { 
return credentials 


+ 检查 用 户 名 和 密码 的 有 效 性 ， 这 
里 用 的 是 硬 编码 的 用 户 名 和 密码 


&& credentials.name === 'tj' 
&& credentials.pass === 'tobi'; Oo 获取 经 过 解析 
} 的 凭证 
connect ( ) 
.usSe((req, res, next) => { 
const credentials = auth (req); 
if (passwordValid(credentials)) { 
next () ; 
} else { 
res.writeHead(401, { 
'WHW-Authenticate': 'Basic realm="example"' 密码 不 正确 时 回 送 
上 
i WWW-Authenticate 
res.end(); 头 部 域 
} 
}) 
.use((req, res) => { 
res.end('This is the secret area\n'); < 一 一 如 果 密 码 正 确 ， 则 
LI 
}) j “ 秘 完 : 
t() 进 入 “秘密 
.listen(3000) ; 区 域 。 人 











[a 





basic-auth 只 提供 了 头 部 域 authorization 的 解析 ， 要 完成 整个 验证 流程 ， 你 需要 提供 
自己 的 密码 检查 函数 ,并 在 中 间 件 组 件 中 调用 ,认证 失败 的 话 还 要 发 送 相应 的 消息 头 回去 。 在 这 
个 例子 中 ， 认 证 成 功 后 会 调用 next () ， 从 而 继续 执行 程序 受 保护 的 部 分 。 

2. 使 用 curl 的 例子 

现在 试 着 用 curl 向 服务 器 发 送 一 个 HTTP 请 求 ， 然 后 你 会 看 到 你 未 被 授权 : 


$ curl http://localhost:3000 -i 

HTTP/1.1 401 Unauthorized 

WHW-Authenticate: Basic realm="Authorization Required" 
Connection: keep-alive 

Transfer-Encoding: chunked 

Unauthorized 


用 HTTP 基本 授权 凭证 发 起 相同 的 请 求 ( 注意 URL 的 开始 部 分 ) 可 以 访问 : 


$ curl --user tj:tobi http://localhost:3000 -i 
HTTP/1.1 200 OK 

Date: Sun, 16 Oct 2011 22:42:06 GMT 
Cache-Control: public, max-age=0 
Last-Modified: Sun, 16 Oct 2011 22:41:02 GMT 
ETag: "13-1318804862000" 

Content-Type: text/plain; charset=UTF-8 
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Accept-Ranges: bytes 
Content-Length: 13 
Connection: keep-alive 
I'm a secret 




















继续 本 节 安 全 这 一 主题 , 我 们 去 看 一 下 csurf 中 间 件 , 它 是 用 来 防护 跨 站 请 求 伪 造 攻击 的 。 


C.3.2 csurf: 跨 站 请 求 伪造 防护 


跨 站 请 求 伪造 (CSRF ) 利用 站 点 对 浏览 器 的 信任 漏洞 进行 攻击 。 经 过 你 的 程序 认证 的 用 户 
访问 攻击 者 创建 或 攻陷 的 站 点 时 , 这 种 站 点 会 在 用 户 不 知情 的 情况 下 代表 用 户 向 你 的 程序 发 起 请 





我 们 举例 说 明 。 假 定 在 你 的 程序 中 ,请 求 DELETE /account 会 导致 用 户 的 账号 被 销毁 〈 尽 
管 只 有 已 登录 用 户 可 以 发 起 请 求 )。 而 用 户 此 时 又 恰好 访问 了 一 个 不 能 防护 CSRF 的 论坛 。 攻 击 


























者 可 以 提交 一 段 脚 本 发 起 DELETE /account 请 求 ， 销 毁 用 户 的 账号 。 对 于 你 的 程序 来 说 ， 这 是 




















很 糟糕 的 状况 ，csurf 中 间 件 可 以 防护 这 样 的 攻击 。 


























csurf 模块 会 生成 一 个 包含 24 个 字符 的 唯一 ID ,认证 令 牌 , 作为 req.session._csrf 附 
到 用 户 的 会 话 上 。 这 个 令 牌 会 作为 隐藏 的 输入 控件 _csrf 出 现在 表单 中 , CSRF 在 提交 时 会 验证 








这 个 令 牌 。 这 个 过 程 每 次 交互 都 会 执行 。 
基本 用 法 


为 了 确保 csurf 可 以 访问 reg.body ._csrf( 隐藏 输入 控件 的 值 ) 和 zeq.session._ csrf， 


你 要 确保 csurf 添加 在 了 boqy-parser 和 express-session 的 下 面 ， 如 下 例 所 示 。” 





代码 清单 C-14 CSRF 防护 


const bodyParser = require('body-parser'); 


const connect = require('connect'); 

const csurf = require('csurf'); 

const session = require('express-session'); 
const sesionOptions = { 


resave: false, 
saveUninitialized: false, 
secret: '1234' 

}; 


在 消息 体 解 析 器 和 会 
CE ne 
.Use (bodyParser.urlencoded({ extended: false })) csurf 中 间 件 组 件 
.usSe (session (sesionOptions)) 
.use(csurf()) 4 
.usSe((req, res, next) => { 
if ('/' != req.url) return next(); < 了 一 一 一 访问 /时 显示 一 个 表单 
const token = req.csrfToken(); 用 这 个 csurf 添加 
const html = “ ee 人 
<form method="post" action="/save"> a 的 
今 


<input type="text" name="_csrf" value="${token}"> 














@ 我 们 用 的 是 1.6.6 版 的 csurf。 
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<button type="submit">Submit</button> 
</form>;} 


res.setHeader('Content-Type', 'text/html'); 
res.end (htmil); 
} 
a 妈 得 到 带 有 正确 令 牌 的 POST 
const html = 、 - 主 沁 户 人 :二 4 一 习 人 二 
<p>Body: S${req.body._csrf}</p> 请 求 后 会 运行 这 个 函数 
<p>Session secret: S${regq.session.csrfSecret}</p> 





res.end (htmil); 

} 

.usSe((err, req, res, next) => { 令 牌 不 正确 时 的 
console.error (err); 音 误 处 理 
res.end('Did you get the csrf token wrong?'); 局 5 


}) 
.listen(3000); 


要 使 用 csurf， 必须 首先 加 载 body-parser 和 会 话 中 间 件 组 件 。 然 后 访问 / 时 会 显示 一 个 
表单 ， 其 中 有 值 为 当前 CSRF 令 牌 的 文本 域 。 因 为 有 这 个 令 牌 , 程序 会 根据 会 话 中 的 密 钥 对 所 有 
特定 类 型 的 请 求 进行 检查 。 当 前 令 牌 可 以 用 *eq.csrfToken 获取 ， 这 个 方法 是 csurf 添加 的 。 
csurf 会 自动 标记 令 牌 不 正确 的 请 求 ,， 所 以 我 们 又 做 了 “ 令 牌 正确 ”处 理 器 和 错误 处 理 器 。 因 为 
这 个 例子 中 用 的 是 文本 域 ， 所 以 你 可 以 修改 令 牌 的 值 ， 看 看 会 发 生 什 么 。 

从 这 个 例子 来 看 ,csurf 会 自动 忽略 特定 类 型 的 请 求 。 这 是 由 选项 ignoreMethods 决定 的 。 
默认 会 忽略 HTTP GET、HEAD 和 OPTIONS ,如果 需 要 的 话 ,可 以 给 csurf 传人 选项 ignoreMethods 
修改 。 

在 Web 开发 的 安全 问题 中 , 还 有 一 点 需要 注意 ,， 即 要 确保 宛 长 的 日 志和 详细 的 错误 报告 不 能 后 
时 出 现在 生产 和 开发 环境 中 。 下 面 我 们 来 看 一 下 errorhandler 模块 , 它 就 是 要 解决 这 个 问题 的 。 















































C.3.3 errorhandler: 开发 过 程 中 的 错误 显示 


errorhandler 模块 很 适合 在 开发 时 使 用 , 它 可 以 基于 请 求 头 域 Aaccept 提供 详尽 的 HTML、 
JSON 和 普通 文本 错误 响应 。 也 就 是 说 它 应 该 在 开发 过 程 中 使 用 ， 不 应 该 出 现在 生产 环境 中 。 






































1. 基本 用 法 
这 个 组 件 一 般 应 该 放 在 最 后 ， 这 样 它 才 能 捕获 所 有 错误 : 
connect () 
.USe((req, res, next) => { 
setTimeout (function () { 
next (new Error('something broke!')); 
,~ 300):; 


}) 


.Use (errorhandler ()); 
2. 接收 HTML 错误 响应 
如 果 按 照 这 里 的 配置 ， 你 在 浏览 右 中 查看 任何 页 面 时 都 会 看 到 图 C-5 所 示 的 Connect 错误 页 
面 ， 显示 错误 消息 、 响 应 状态 和 全 部 栈 跟踪 信息 。 
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$ Error: something brokel 
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Connect 


500 Error: something broke! 


at Object.handle VUsers/tj/Projects/node-in-action/source/connect-middleware-errorHandlerjs:12:10) 
at next /Users/tj/Projects/connect/ib/proto.js:179:15) 

at Objectlogger [as handle] VUsers/tyProjects/connectiib/middleware/loggerjs:155:5) 

at noxt YUsors/tj/Projocts/conncotib/proto.js:179:15) 

at Function.handle /Users/tj/Projects/connect/lib/proto.js:192:3) 

at Server.app (Users/tj/Projects/connect/lib/connect.js:53:31) 

at Server.emit (events.js:67:17) 

at HTTPParser.onincoming (http.js:1134:12) 

at HTTPParser.onHeadersComplete (http.js:108:31) 

at Socket.ondata (http.js:1029:22) 





图 C-5 默认 的 errorhandler HTML 显示 在 浏览 器 中 的 样子 





3. 接收 普通 文本 错误 响应 


假定 你 正在 测试 一 个 用 Connect 搭建 的 APL, 它 离 返回 一 大 堆 HTML 的 理想 状况 
离 , 所 以 errorhandler 默认 会 用 text /plain 格式 做 响应 ,这 非常 适合 curl (1) 





行 HTTP 客户 端 。 在 stdout 中 的 输出 如 下 所 示 : 


$ curl localhost:3000 -H "Accept: text/plain" 


Error: something broke! 
at Object.handle (/Users/tj/Projects/node-in-action/source 





ww /connect-mi 
at 

at 

ww /lib/middle 
at 

at Function.handle 
at Server.app 
at 

at HTTPParser. 
at HTTPParser. 
at 


4. 接收 JSON 


ddleware-errorHandler.js:12:10) 


next (/Users/tj/Projects/connect/l1ib/proto.js:179:15) 
Object.logger [as handle] (/Users/tj/Projects/connect 


ware/logger.js:155:5) 








next (/Users/tj/Projects/connect/l1ipb/proto.js:179:15) 
(/Users/tj/Projects/connect/lib/proto.js:192:3) 





(/Users/tj/Projects/connect/lib/connect.js:53:31) 


Server.emit (events.js:67:17) 


onIncoming (http.js:1134:12) 
onHeadersComplete (http.js:108:31) 


Socket .ondata (http.js:1029:22) 


昔 误 响应 


还 


辽 


有 很 大 距 
样 的 命令 


如 果 你 发 送 的 HTTP 请求 带 有 HTTP 请 求 头 Accept: application/json， 会 得 到 下 面 的 


JSON 响应 : 





$ curl http://localhost:3000 -H "Accept: application/json" 
{"error":{"stack":"Error: something broke!\n 
ww at Object.handle (/Users/tj/Projects/node-in-action 


ww /sou 
ww at n 


rce/connect-middleware-errorHandler.js:12:10)\n 
ext 


(/Users/tj/Projects/connect/lib/proto.js:179:15) \n 
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t Object .logger [as handle] (/Users/tj/Projects 
connect/1ip/middqdleware/logger.js:155:5)ANn 

t next (/Users/tj/Projects/connect/1Lipbp/proto.js:179:15) ANDn 

t Function.handle (/Users/tj/Projects/connect/l1ib/ 

.js:192:3)\n 

t Server.app (/Users/tj/Projects/connect/lib/connect.js:53:31)\n 
t Server.emit (events.js:67:17)\n 

t HTTPParser.onIncoming (http.js:1134:12)\n 

t HTTPParser.onHeadersComplete (http.js:108:31)\n 

t Socket.ondata (http.js:1029:22)","message":"something broke!"}} 


es 
soreorrrrs 
Oppgy~、yg 


yo oo9 oy 





§ 
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我 们 已 经 对 JSON 响应 做 了 额外 的 格式 化 处 理 ， 这 样 看 起 来 更 清晰 , 但 errorhandler 发 
送 的 JSON 响应 是 经 过 JSON. stringify () 处 理 的 紧凑 格式 。 

觉得 自己 是 Connect 安全 高 手 了 吗 ? 或 许 还 不 是 , 但 你 掌握 的 基础 知识 已 经 可 以 保证 程序 的 
安全 了 。 接 下 来 我 们 要 介绍 一 个 非常 常见 的 Web 程序 功能 : 提供 静态 文件 。 


C.4 提供 静态 文件 


提供 静态 文件 是 男 一 个 很 多 Web 程序 需要 ,但 Node 核心 没有 提供 的 功能 。 不 过 Connect 用 
一 些 简单 的 模块 满足 了 这 个 需求 。 

本 节 会 再 介绍 两 个 Connect 的 官方 支持 模块 ， 这 次 主要 是 用 于 返回 来 自 文件 系统 的 文件 ， 就 
像 Apache 和 Neginx 之 类 的 HTTP 服务 器 做 的 那样 ， 但 只 需 稍 作 配 置 就 可 以 添加 到 Connect 项 目 中 : 
口 serve-static 一 一 将 文件 系统 中 给 定 根 目录 下 的 文件 返回 给 客户 端 ; 
D serve-index 当 请 求 的 是 目录 时 ， 返回 那个 目录 的 列表 。 
我 们 先 介绍 如 何 用 一 行 代 码 通过 serve-static 模块 提供 静态 文件 服务 。 



















































































C.4.1 serve-static: 自动 将 文件 发 给 浏览 器 


serve-static 模块 实现 了 一 个 高 性 能 的 、 灵活 的 、 功能 丰富 的 静态 文件 服务 需 ， 文 持 HTTP 
缓存 机 制 、 范 围 请 求 等 。 更 重要 的 是 , 它 有 对 恶意 路 径 的 安全 检查 , 默认 不 允许 访问 隐藏 文件 ( 文 
件 名 以 .开头 ), 会 拒绝 有 害 的 null 字 节 。serve-static 本 质 上 是 一 个 安全 的 、 完 全 能 胜任 的 
静态 文件 服务 中 间 件 组 件 ， 可 以 保证 跟 目 前 各 种 HTTP 客户 端的 兼容 。 

1. 基本 用 法 

假定 你 的 程序 遵循 典型 的 场景 ， 要 返回 ./public 目录 下 的 静态 资源 文件 。 这 可 以 用 一 行 代码 
实现 : 
























































app.use (serveStatic('public')); 


按照 这 个 配置 ，serve-static 会 根据 请 求 的 URL 检查 ./public/ 中 的 普通 文件 。 如 果 文 件 存 
在 ， 响 应 中 content-Type 域 的 值 默认 会 根据 文件 的 扩展 名 设 定 ， 并 传输 文件 中 的 数据 。 如 果 
被 请 求 的 路 径 不 是 文件 ， 则 调用 next () ， 让 后 续 的 中 间 件 〈 如 果 有 的 话 ) 处 理 该 请 求 。 

我 们 来 测试 一 下 ， 创 建 一 个 名 为 ./public/foo.js 的 文件 ， 其 内 容 为 console.1og('tobi')， 
用 带 -i 标记 的 curl (1) 向 服务 器 发 送 请 求 ， 告 诉 它 输出 HITP 响应 头 。 你 会 看 到 正确 设 定 的 与 
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绥 存 相关 的 HTTP 响应 头 ， 反映 .js 扩展 名 的 content-Type， 以 及 传 过 来 的 内 容 : 


$ curl http://localhost/foo.js -i 
HTTP/1..1 200. OK 

Date: Thu, 06 Oct 2011 03:06:33 GMT 
Cache-Control: public, max-age=0 
Last-Modified: Thu, 06 Oct 2011 03:05:51 GMT 
Dhags "21=1317870351000" 
Content-Type: application/javascript 
Accept-Ranges: bytes 

Content-Length: 21 

Connection: keep-alive 
console.log('tobi'); 


因为 请 求 路 径 就 是 当 作文 件 路 径 用 的 ， 所 以 在 目录 内 层 的 文件 也 能 按 你 期 望 的 那样 访问 。 比 如 
说 ， 你 的 服务 器 上 可 能 收 到 了 一 个 GET /javascripts/jquery.js 请 求 和 一 个 GET /stylesheets/ 
app .css 请 求 ， 它 会 分 别 返 回 ./public/javascripts/jquery.js 和 ./public/stylesheets/ app.css 文件 。 

2. 使 用 带 挂 载 的 serve-static 

有 了 时 程序 会 用 /public 、/assets 和 /static 之 类 的 路 径 做 前 缀 路 径 名 。Connect 中 有 挂 载 的 概念 ， 
可 以 从 多 个 目录 中 提供 静态 文件 。 只 需 把 程序 挂 载 到 你 想 要 的 位 置 。 我 们 在 第 5 章 讲 过 ， 中 间 件 
本 身 不 知道 它 是 从 哪里 挂 载 的 ， 因 为 前 缀 被 去 掉 了 。 

比如 说 ， 请 求 GET /app/files/js/jquery .js 对 挂 载 在 /app/files 上 的 serve-static 
来 说 就 相当 于 GET /js/jquery。 这 能 很 好 地 实现 前 级 功能 ， 因 为 前 缀 的 /app/files 不 会 出 现在 
文件 路 径 解 析 中 : 


app.use('/app/files', connect.static('public')); 


原来 那个 请 求 GET /foo.js 不 能 用 了 。 因 为 请 求 中 没有 出 现 挂 载 点 ， 所 以 中 间 件 不 会 被 调 
但 带 前 缀 的 请 求 CET /app/files/foo0.js 会 得 到 这 个 文件 : 


$ curl http://localhost/foo.js 

Cannot get /foo.js 

$ curl http://localhost/app/files/foo.js 
console.log('tobi'); 


3. 绝对 与 相对 目录 路 径 

请 记 住 传 到 serve-static 中 的 路 径 是 相对 于 当前 工作 目录 的 。 也 就 是 说 将 "public "作为 
路 径 传 人 会 被 解析 为 process.cwd() + "public"。 

然而 有 时 你 可 能 想 用 绝对 路 径 指 定 根 目录 ， 变 量 _ airname 可 以 帮 你 达成 这 一 目的 : 


app.use('/app/files', connect.static(_ dirname + '/public')); 


4. 请 求 目录 时 返回 index.html 

serve-static 还 能 提供 index.html 服务 。 当 请 求 的 是 目录 ， 并 且 那 个 目录 下 有 index.html 
时 ， 它 可 以 返回 这 个 文件 作为 响应 。 

对 于 Web 程序 中 的 资源 型 文件 来 说 , 比如 CSS 、JavaScript 和 图 片 ，serve-static 很 好 用 
但 如 果 想 让 用 户 下 载 目 录 中 的 文件 列表 怎么 办 ?这 是 serve-ingdex 要 解决 的 问题 。 
















































































— 
LI 





















































306 


附录 C Connect 的 官方 中 间 件 





C.4.2 





serve-index: 生成 目录 列表 


serve-index 模块 是 一 个 提供 目录 列表 的 小 型 中 间 件 , 用 户 可 以 用 它 浏览 远程 文件 。 图 C-6 
展示 了 这 个 组 件 提供 的 界面 ， 其 有 完整 的 搜索 输入 框 、 文 件 图 标 和 可 点 击 的 面包 导 导 航 。 
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图 C-6 用 




















1. 基本 用 法 
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serve-index 中 间 件 组 件 提供 目录 列表 服务 


这 个 组 件 要 配合 serve-static 使 用 ,由 serve-static 提供 真正 的 文件 服务 ; 而 serve- 




















ingex 只 是 提供 列表 。 其 设置 可 能 像 下 面 的 代码 这 样 简单 ,请 求 G 


const connect = 
const serveStatic = 
const servelIndex = 


connect () 
.usSe (serveIndex('public')) 
.usSe (serveStatic('public')) 
.listen(3000); 


2. 使 用 带 挂 载 的 serve-index 


require('connect'); 
require('serve-static'); 
require('serve-index'); 


BT /会 得 到 /public 目录 的 列表 : 





通过 中 间 件 挂 载 ， 你 可 以 给 serve-static 和 serve-index 中 间 件 加 上 任何 你 想 要 的 路 
径 做 前 级 ， 比 如 下 例 中 的 GET /files。 这 里 的 选项 icons 用 来 启用 图 标 ，hi dqen 表明 两 个 组 





件 都 可 以 查看 并 返回 隐藏 文件 : 


connect () 
.use('/files', 
.use('/files', 
.listen(3000); 


serveIndex('public', 
serveStatic('public', 


现在 可 以 轻松 地 在 文件 和 目录 中 导航 了 。 


{ LOONnSS 
{ hidden: 


tre 


hidden: 
true })) 


true })) 
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口 ECMAScript 标准 ” ECMAScript 是 由 Ecma 国际 标准 化 的 脚本 语言 规范 。ECMAScript 有 
几 个 标准 ， 本 书 关注 的 是 ECMAScript 2015( ECMAScript 第 6 版 )。 为 确保 他 们 的 解释 器 
与 为 其 他 实现 而 写 的 JavaScript 兼容 ，JavaScript 实现 者 采用 了 ECMAScript 标准 。 

口 异步 不 一 定 按照 出 现 的 顺序 执行 的 代码 。 在 Nodejs 中 ， 这 个 术语 通常 用 来 描述 那些 接 
受 回 调 函 数 为 参数 的 API， 因 为 这 些 回 调 函 数 是 在 将 来 的 某 一 时 点 运行 的 。 比 如 说 , 作为 
fs .readFile 人 参数 的 那个 回调 函数 ， 会 在 文件 读 取 完 成 后 收 到 该 文件 中 的 内 容 。 

口 语义 版 本 ”使 用 三 个 数字 表明 版 本 兼容 性 的 惯用 法 : 主 版 本 号 、 次 版 本 号 、 修 订 号 ， 表 
示 为 1.0.2 ( 主 版 本 号 为 1， 次 版 本 号 为 0， 修 订 号 为 2 )。 一 个 依赖 于 1.0.2 版 本 的 项 目 应 
该 能 跟 1.1.1 兼 容 ， 但 不 能 跟 2.0.2 兼容 。 

口 Promise Promise 对 象 是 标准 化 的 ECMAScript 2015 API， 用 于 表示 现在 、 将 来 可 获得 ， 

或 永远 都 得 不 到 的 值 。 

口 非 阻塞 I/O ”阻塞 的 操作 会 让 线程 挂 起 ， 直 到 操作 完成 才 会 继续 执行 。Node 用 的 是 非 阻 

塞 WO， 即 从 文件 或 网 络 等 资源 读 取 数 据 时 不 会 阻塞 线程 的 执行 。 

口 npm Node 的 包 管理 器 。 用 来 安装 存放 在 大 型 中 心 仓库 上 的 包 ， 以 及 管理 Node 项 目 中 

的 依赖 项 。 

口 libuv ”Node 用 的 多 平台 异步 IO 库 。Julia 等 语言 也 在 用 这 个 库 。 

口 核心 模块 ”Node 自 带 的 那些 库 。 

口 箭头 函数 ”简写 的 函数 。 即 在 将 函数 作为 参数 传 给 其 他 函数 时 , 用 () => {} 而 不 是 

function () {} 这 样 的 写法 。 如 果 函 数 只 接受 一 个 参数 ， 那 么 括号 可 以 忽略 。 

口 解构 ECMAScript 2015 引入 了 解构 ， 人 允许 将 对 象 和 数组 分 解 为 变量 和 常量。 比如 说 ， 
const { name } = { name: 'Alex' } 的 计算 结果 是 创建 一 个 名 为 name, 值 为 Alex 
的 常量 。 

口 JSON (JavaScript 对 象 表示 法 ) JSON 是 一 种 轻 量 的 数据 交换 格式 ， 基 于 JavaScript 的 

子 集 ， 易 于 阅读 和 编写 。 

口 抽象 接口 ”没有 具体 实现 的 API 的 程序 化 描述 。Node.js 中 的 流 API 就 是 抽象 接口 。 
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口 剩余 参数 ”ECMAScript 2015 中 的 剩余 参数 语法 允许 我 们 将 一 个 不 定数 量 的 参数 表示 为 
一 个 数组 。 比 如 要 命名 两 个 参数 , 但 其 余 参 数 都 放 在 数组 中 , 可 以 表示 为 function (a， 
pb，. . .rest) 。 还 可 以 跟 解 构 配合 使 用 来 复制 对 象 : const newobject = { .. .olgdobject }。 

口 事件 ”导致 某 个 函数 被 调用 的 字符 串 。 该 函数 被 称 为 对 象 监 昕 器。 发 出 事件 的 是 发 射 器 。 

Node 中 用 来 创建 发 射 吉 的 基 类 是 Event Emitter。 

口 事件 轮 询 Node 的 事件 轮 询 等 待 外 部 事件 ， 并 将 它们 转化 为 回调 函数 的 调用 。 其 他 系统 

采用 类 似 的 机 制 ( 消息 派发 器 和 运行 轮 询 ) 快速 将 事件 路 由 给 相应 的 事件 处 理 器 。 

口 REPL 〈 读 取 - 计 算 -输出 -循环 ) 可 以 用 来 计算 代码 及 查看 结果 的 命令 行 界面 。 
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口 闭 包 JavaScript 函数 能 捕获 在 其 封闭 作用 域内 定义 的 变量 。 比 如 在 函数 A 内 定义 一 个 函 

数 B， 则 B 能 访问 A 中 定义 的 所 有 值 。 

D package.json Node 项 目 中 的 文件 ， 用 来 定义 项 目 名 称 、 作 者 、 版 权 许可 和 依赖 项 。 所 

有 Node 程序 和 库 中 都 应 该 有 这 样 一 个 文件 。 

口 模块 ”Node 模块 是 包含 JavaScript 代码 的 文件 。 可 以 输出 值 (一 般 是 函数 和 常量 ) 供 其 

他 文件 使 用 。 

口 栈 跟 踪 ”截止 到 错误 发 生 时 所 执行 过 的 程序 指令 。 

口 内 容 管理 系统 (CMS) Web 程序 ， 用 来 编辑 文本 和 图 片 ， 编 辑 好 的 内 容 将 会 显示 在 面向 

公众 的 网 站 上 。 

口 流程 控制 (或 控制 流程 语句 执行 的 顺序 。 因 为 Node 是 异步 的 ， 所 以 控制 流 很 重要 。 
JavaScript 中 有 很 多 种 处 理 控制 流 的 办 法 ， 包 括 回调 、Promise、 生 成 需 、 基 本 循环 原 语 ， 
以 及 遍历 器 。 在 Node 中 ， 流 控制 是 指 将 异步 任务 的 执行 顺序 分 组 的 办 法 。 

口 回调 函数 已 经 被 传 给 另 一 个 函数 ， 并 且 可 能 稍 后 会 调用 的 函数 。 

口 回调 赃 套 ”回调 内 还 有 回调 。 在 把 某 个 回调 函数 作为 参数 传 给 一 个 函数 时 ， 某 些 情况 下 

有 必要 在 这 个 回调 函数 内 再 定义 一 个 回调 函数 。 

D 全 局 作用 域 因为 作用 域 是 指 值 可 以 访问 的 范围 ， 所 以 全 局 作用 域 的 值 在 程序 中 的 任何 










































































地 方 都 可 以 访问 。 
口 CommonJS 模块 规范 用 于 定义 应 该 从 当前 JavaScript 文件 中 输出 什么 的 一 种 模块 格式 。 
参见 模块 。 


口 状态 ”程序 中 的 所 有 变量 在 指定 时 间 点 上 的 值 。 
口 属性 ”JavaScript 对 象 是 包含 键 值 对 的 集合 ， 这 些 键 值 对 就 是 对 象 的 属性 。 
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口 表单 编码 ”在 向 Web 服务 器 发 送 HTTP PosT 请 求 时 ， 会 包含 一 个 简单 的 表单 PosT， 表 
单 中 的 内 容 会 编码 为 请 求 主体 。 最 常用 的 格式 application/x-www-form-urlencoded,， 
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类 似 于 URL 编码 ， 会 将 不 安全 的 ASCII 字符 替换 为 百 分 号 。 

口 模板 “用 于 生成 HTML 的 普通 文本 格式 ， 可 以 包含 脱 和 人 数据 和 JavaScript 代码 ， 以 便 精简 

HTML 的 语法 。 

口 MIME (多 用 途 互 联网 邮件 扩展 ) 这 是 一 个 互联 网 标准 ， 用 于 往 电 子 邮 件 和 多 部 分 消息 
体 中 添加 非 文本 数据 ， 以 便 让 电子 邮件 客户 端 可 以 显示 HIML 、 图 片 和 非 ASCII 字符 集 
中 的 文本 。 

口 对 象 - 关 系 映射 “ORM) 对 程序 员 友 好 的 数据 结构 ( 比如 JavaScript 对 象 ) 和 数据 库 的 

数据 结构 ( 比如 表 和 外 键 ) 两 者 之 间 的 映射 是 用 这 样 的 库 建立 的 。 

口 套路 化 代码 ”经 常 复制 并 且 可 以 自动 生成 的 代码 。 

口 路 由 “给 定 的 路 由 处 理 器 需要 处 理 的 URL 片段 和 HTTP 动词 。 

口 路 由 处 理 器 ”用户 定义 的 回调 函数 ， 在 有 HTTP 请 求 发 送 到 Web 程序 时 运行 。 路 由 处 理 
器 一 般 会 生成 内 容 ， 这 些 内 容 可 能 是 来 自 数据 库 的 ， 或 者 是 对 数据 库 进 行 修改 ， 然 后 生 
成 响应 消息 。 这 些 响 应 消息 可 能 是 用 模板 生成 的 ， 也 有 可 能 是 用 JSON 之 类 的 格式 。 

口 客户 端 包 经 过 预 处 理 的 JavaScript 代码 ， 通 党 来自 多 个 源 文件 ， 经 过 最 小 化 和 压缩 后 发 

送 到 客户 端 。 

口 静态 资源 文件 ”无须 Web 服务 器 做 任何 额外 处 理 就 可 以 作为 响应 消息 的 文件 。 通 常 包 括 

图 片 、CSS 文件 和 客户 端 JavaScript 文件 。 

口 cURL 一 个 用 来 发 送 HTTP 请 求 的 命令 行 工 具 和 程序 库 。 经 常用 作 调 试 工具 ， 可 以 快速 

检查 Web 服务 器 对 请 求 的 响应 。 

口 数据 库 模 型 ” 跟 使 用 数据 库 的 原生 语言 相 比 ， 设 计 良 好 的 数据 模型 会 让 程序 员 感 觉 跟 数 

据 库 表 或 文档 的 交互 更 轻松 。 

口 REST 表述 性 状态 转移 ) ，RESTful API 无 状态 Web API 使 用 一 组 HTTP 预先 定义 好 
的 操作 。 这 些 操作 是 基于 HTTP 动词 的 ， 最 常用 的 是 CET、POST、PUT 和 DELETE。 
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口 源码 映射 ”一 个 文件 ， 浏 览 器 中 的 调试 器 可 以 据 此 将 转译 后 源码 文件 中 的 代码 映射 到 原 
台 文件 中 的 对 应 行 上 。 

口 Webpack 加 载 器 ”转换 或 转译 源码 。 

口 Webpack 插件 ”修改 构建 进程 本 身 的 行为 ， 不 一 定 会 改变 输出 文件 。 

口 方法 链 在 上 一 个 执行 的 方法 的 返回 值 上 运行 一 个 方法 。 

口 流 高 效 的 数据 输入 和 (或 ) 输出 通道 ， 文 本 或 二 进 制 数据 都 可 以 。Node 支持 可 读 、 可 
写 和 其 他 流 ， 并 且 这 些 流 可 以 用 管道 连接 到 一 起 。 

口 构建 系统 ”一 套 工 具 和 配置 文件 ， 其 所 生成 的 JavaScript 能 在 浏览 器 中 运行 更 高 效 。 

口 管道 ”将 一 个 数据 输出 连 到 另 一 个 输入 上 。 在 UNIX 中 ， 进 程 是 用 竖 线 符 〈 1 ) 连 成 管道 
的 ; 在 Node 中 ， 流 是 用 方法 链 连 成 管道 的 。 
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口 剪 毛 器 ”检查 源码 格式 的 正确 性 。 剪 毛 器 可 以 按照 一 组 剪 毛 规则 对 项 目 进行 检查 ， 从 而 
强化 指定 的 编程 风格 。 

口 测试 引擎 ， 运行 并 整理 单元 测试 结果 的 程序 ， 一 般 可 以 同时 处 理 多 个 文件 。 

口 转译 ”也 称 为 源码 到 源码 编译 ，JavaScript 转译 器 可 以 将 一 种 ECMAScript 转换 成 另外 一 
种 。 最 常用 的 是 将 更 先进 的 ES2015 转换 成 向 后 兼容 的 ECMAScript 5, 后 者 能 用 在 更 多 浏 
览 器 上 。 还 有 TypeScript， 它 是 JavaScript 的 超 集 ， 也 能 转译 为 ES5 或 ES2015。 
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口 Web 框架 用 来 开发 Web 程序 的 一 组 函数 库 ， 可 以 用 插件 或 中 间 件 进行 扩展 。 

口 模型 -视图 -控制 器 (MVC) 将 软件 分 解 为 组 件 的 设计 模式 。 模 型 管理 数据 和 逻辑 ， 视 图 

将 数据 转化 成 用 户 界面 ， 控 制 器 则 将 交互 转化 成 对 模型 和 视图 的 操作 。 

口 单 页 Web 程序 一 次 性 返回 给 浏览 器 的 程序 ， 不 需要 整 页 刷新 。 如 果 程 序 需要 改变 浏览 
絮 中 的 URL， 可 以 用 HTMLS5 的 历史 API 让 用 户 觉 得 URL 已 经 变 了 ， 而 浏览 器 已 经 从 服 
务 器 上 加 载 了 新 的 页 面 。 

口 同 构 ”通过 共享 相同 的 代码 而 能 够 在 客户 端 和 服务 器 端 运行 的 JavaScript 程序 。 

口 GET 参数 ”出 现在 问号 之 后 的 URL 参数 ， 分 隔 符 是 & 符号 。 

口 关系 型 数据 库 ”基于 所 存储 的 实体 及 其 关系 而 形成 的 数据 库 结构 。 

口 HTTP 动词 HTTP 方 法 (GET、POST、 PUT、PATCH、 DELETE ) 表示 应 该 在 远程 资源 

上 执行 的 动作 。 

口 解 耦 ”如 果 项 目 中 的 某 个 函数 、 类 或 模块 可 以 轻松 蔡 换 ， 或 者 用 在 其 他 项 目 中 ,那么 它 

就 是 松散 耦合 的 。 

口 全 栈 框架 ”如 果 框 架 中 所 包含 的 功能 既 可 以 用 于 客户 端 ， 也 可 以 用 于 服务 器 端 代码 ， 则 
说 它 是 全 栈 框架 。 那 通常 意味 着 这 个 框架 中 有 处 理 HTTP 请 求 、 请 求 路 由 、 数 据 库 建 模 
和 与 浏览 器 中 运行 的 代码 进行 通信 等 功能 的 函数 库 。 

口 中 间 件 “能够 按 顺序 调用 来 修改 HTTP 请 求 和 响应 的 函数 。 

D 数据 库 适 配器 ”一 些 通用 的 数据 库 的 函数 库 ， 可 以 用 特定 的 适配器 进行 扩展 ， 以 实现 特 

定数 据 库 所 需 的 功能 。 
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口 bcrypt ”密码 散 列 函 数 。 由 于 这 个 函数 能 将 任意 数量 的 数据 映射 为 固定 大 小 的 字符 
此 用 户 密码 的 明文 经 过 处 理 后 可 以 安全 地 存储 在 数据 库 中 。 

口 模板 语言 轻 量 的 标记 语言 ， 可 以 转换 为 HTML， 并 能 够 从 代码 中 注入 值 ， 循 环 遍历 数 
组 或 对 象 。 

口 密码 盐 ”用 来 作为 散 列 函数 输入 的 随机 数据 ， 可 以 加 大 字典 攻击 的 难度 。 

口 单线 程 ”运行 的 程序 ( 进程 ) 可 以 有 多 个 并 发 执行 的 线程 。JavaScript 的 模型 是 使 用 单线 
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程 ， 但 在 发 生 事件 时 ,线程 可 以 切换 上 下 文 运行 不 同 的 代码 。 浏 览 器 中 的 事件 是 用 户 点 击 
按钮 之 类 的 交互 动作 。 在 Node 中 ,通常 是 IO 事件 ， 比 如 网 络 操 作 或 从 硬盘 中 读 取 数据 。 

口 第 三 方 中 间 件 不 是 由 初始 的 Web 库 或 框架 的 作者 发 布 的 中 间 件 组 件 。 

口 内 容 协商 "HTTP 标准 的 一 部 分 ， 用 来 处 理 相同 URI 上 不 同 版 本 的 文档 。 如 果 服 务 器 支持 

内 容 协 商 ， 那 么 用 户 代 理 ( 浏览 器 ) 可 以 请 求 不 同 格式 的 数据 。 

口 响应 对 象 ” 决 定 服务 器 将 会 如 何 响应 某 个 HTTP 请 求 的 对 象 。 包 含 响应 主体 ( 通常 是 一 

个 Web 页 面 ) 和 消息 头 。 

口 CSS 预 处 理 器 将 CSS 超 集 转换 成 浏览 器 能 够 解释 的 CSS。Sass 和 LESS 样式 表 语 言 都 

包含 CSS 预 处 理 器 ， 并 且 这 些 语言 可 以 添加 变量 、 舱 套 和 mixin 等 功能 。 

D Redis 哈 希 ”一 个 字符 串 和 值 的 映射 ， 用 来 表示 Redis 数据 库 中 的 对 象 。 

D Redis 数据 库 ”内 存 数 据 库 ， 可 以 作为 缓冲 区 和 消息 代理 使 用 。 常 用 在 Web 程序 中 存储 
用 户 会 话 和 消息 推送 。 
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口 有 意义 的 空格 JavaScript 用 大 括号 、 分 号 和 换行 来 分 隔 语句 。 如 果 需 要 一 个 新 的 词法 块 ， 
则 用 函数 或 控制 语句 。 而 在 某 些 语 言 中 ， 空 格 是 有 意义 的 ， 比 如 Pug 中 的 每 行 代码 都 会 
用 不 同 数量 的 空格 形成 缩 进 ， 从 而 形成 代码 块 。 

D mixin 通常 是 指 一 个 类 ， 这 个 类 中 定义 了 用 在 其 他 类 中 的 方法 。 在 Sass 中 ，mixin 是 CSS 

声明 的 分 组 ， 可 以 在 多 处 重用 ; 在 Pug 中 ，mixin 用 来 定义 可 重用 模板 片段 。 

口 区 块 lambda 因为 lambda 是 匿名 函数 ， 所 以 Hogan 中 的 区 块 l ambda 是 将 函数 与 模板 

中 的 标签 关联 起 来 的 一 种 办 法 。 

口 XSS 〈 跨 站 脚本 ) 攻击” 如 果 Web 程序 接受 来 自 表单 或 URL 参数 的 用 户 输 入 ， 并 且 那 些 
值 会 重新 出 现在 模板 中 ， 则 有 可 能 会 被 注入 恶意 代码 。 为 了 避免 遭受 这 种 攻击 ， 必 须 先 
将 收 到 的 值 进行 转 义 。 

口 子 模板 〈partial) 小 型 的 可 重用 模板 。 

口 词法 作用 域 ”变量 的 可 见 性 是 由 它 的 作用 域 决 定 的 。 在 JavaScript 中 ， 添 加 一 个 函数 会 
增加 新 的 作用 域 层级 。 那 个 函数 中 定义 的 所 有 变量 对 该 函数 中 定义 的 所 有 函数 来 说 都 是 
可 见 的 。 
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口 ACID (Atomicity、Consistency 、lsolation 、Durability， 原 子 性 、 一 致 性 、 隔 离 性 和 耐用 
性 ) ”数据 库 要 想 满 足 ACID ， 其 操作 必须 是 原子 性 的 〈 操 作 或 者 成 功 ， 或 者 失败 ， 但 失 
败 后 数据 库 必须 保持 原样 )、 一 致 性 的 〈 数 据 只 能 以 允许 的 方式 改变 )、 隔 离 性 的 (确保 能 
够 并 发 执行 ) 和 耐用 性 的 ( 变化 发 生 后 ， 即 便 经 历 了 系统 崩 演 或 重启 ， 也 必须 保留 下 来 )。 

口 Web worker ”允许 JavaScript 运行 在 浏览 器 后 台 线 程 上 的 办 法 。 
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口 BSON MongoDB 中 表示 对 象 的 二 进 制 格式 。 对 象 是 由 一 组 排 好 序 的 元 素 组 成 的 。 元 素 是 
由 域名 、 类 型 、 值 构成 的 。BSON 支持 的 类 型 包括 字符 串 、 整 型 、 日 期 和 JavaScript 代码 。 
口 面向 文档 的 数据 库 ”存储 半 结 构 化 数据 的 数据 库 ， 这 些 数据 没有 预先 定义 好 的 模式 ， 有 
时 是 JSON 或 XML。 比 如 MongoDB 和 CouchDB。 

口 发 布 /订阅 一 种 能 够 将 消息 发 送 给 多 个 接收 者 的 模式 。 

口 分 布 式 数据 库 ”存储 在 多 台 计 算 机 上 的 数据 库 ， 虽然 不 一 定 ， 但 有 可 能 分 布 在 不 同 的 地 
理 位 置 上 。 

口 复制 集 一 组 MongoDB 进程 ， 可 以 让 数据 集 保持 一 致 。 

口 NoSQL 不 用 关系 型 数据 库 中 那 种 表格 关系 的 数据 库 。 

口 关系 代数 ”关系 型 数据 库 的 理论 基础 ， 对 所 存储 的 数据 和 在 其 上 执行 的 查询 进行 建 模 的 




















依据 。 
口 缓存 记忆 (memoize) 一 种 优化 技术 ， 用 于 将 函数 的 结果 保存 起 来 ， 这 样 就 不 用 再 次 调 
用 它 了 。 


口 主键 ”数据 库 表 中 用 来 唯一 标识 每 一 行 记录 的 那 一 列 。 

口 查询 构建 器 ”为 程序 员 提 供 便利 ,不 用 再 手动 编写 SQL 的 API。 

口 抽象 漏洞 ”尝试 将 底层 实现 的 大 量 细 节 和 问题 隐藏 起 来 ， 以 降低 复杂 度 。 
口 守护 进程 ”在 后 台 运 行 的 程序 ， 通常 是 在 系统 启动 时 自动 启动 的 。 

口 数据 库 模 式 ”数据库 中 数据 及 其 相互 关系 的 正式 定义 。 它 是 数据 库 的 设计 。 
口 数据 库 事务 ”按照 ACID 属性 组 合 在 一 起 的 一 个 或 多 个 数据 库 操作 。 
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口 BDD 行为 驱动 开发 ) TDD 的 扩展 ， 其 用 不 同 的 API 风格 来 鼓励 将 注意 力 放 在 流程 中 的 
测试 点 上 ， 测 试 什么 ， 不 测试 什么 ， 以 及 一 次 做 多 少 测试 。 同 时 尽量 改善 测试 失败 提示 
及 单元 测试 名 称 的 可 理解 性 。 

口 模拟 对 象 “mock) 行为 像 真正 的 对 应 物 的 值 或 对 象 ， 但 通常 要 简单 得 多 ， 只 是 为 了 测试 
模拟 了 刚好 够 用 的 行为 。 所 以 在 测试 中 一 般 不 会 访问 真正 的 文件 或 网 络 ， 因 为 速度 可 能 
会 比较 慢 ， 如 果 进 行 破坏 性 操作 的 话 ， 还 会 有 危险， 模拟 物 可 以 安全 地 模拟 这 些 行 为 。 

口 单元 测试 ”在 小 的 测试 集 (单元 ) 中 孤立 测试 模块 的 一 小 部 分 ， 比 如 函数 或 类 的 方法 。 

口 断言 ”确保 表达 式 的 计算 结果 符合 期 望 。 可 以 是 一 个 简单 的 布尔 语句 、 等 式 、 或 其 他 任 
何 东西 。 在 Node 中 ,断言 失败 时 会 抛 出 异常 。 测 试 运行 器 可 以 捕获 这 些 异 常 ， 并 进行 汇 
总 以 形成 测试 报告 。 

D typeof JavaScript 操作 符 ， 其 可 以 根据 指定 对 象 或 值 返回 一 个 字符 串 。 

口 功能 测试 ”测试 整个 系统 中 的 某 个 功能 。 在 Web 开发 中 ， 这 意味 着 要 同时 测试 浏览 器 和 

服务 器 端 ， 是 全 栈 测 试 。 

口 测试 运行 器 ”管理 测试 加 载 、 执 行 和 结果 收集 以 便 显示 的 程序 。Mocha 就 是 测试 运行 句 。 

口 测试 驱动 开发 (TDD) 先 写 测试 ， 再 写 要 进行 测试 的 代码 。 
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口 Elastic Beanstalk ”亚马逊 提供 的 协调 性 服务 ， 用 于 向 它 的 其 他 服务 ， 比 如 EC2， 做 脚本 
部 署 。 


口 亚马逊 EC2 (亚马逊 弹性 计算 云 ) 亚马逊 的 虚拟 计算 机 服务 。 

口 Docker 映像 ”Docker 用 来 创建 容器 的 文件 系统 的 映像 。 

D dyno Heroku 对 自己 的 容器 的 叫 法 。 用 来 运行 服务 器 以 及 Heroku 的 服务 器 上 独立 环境 
中 的 所 有 命令 。 

口 内 容 交付 网 络 (CDN) 交付 静态 内 容 的 分 布 式 服务 器 。 

口 sudo 在 需要 使 用 其 他 用 户 权 限 运 行程 序 时 使 用 的 命令 。 一 般 在 需要 特殊 权限 时 使 用 ， 
比如 编辑 系统 配置 文件 。 
口 SSH (安全 shell) ”提供 一 个 连接 远程 计算 机 的 加 密 命 令 行 (或 X11 ) 界面 。 在 Web 开 
发 人 员 刚 开始 配置 新 的 服务 器 ， 或 连接 到 服务 器 运行 维护 或 调试 命令 时 使 用 。 

D 容器 ”一 种 虚拟 技术 ， 是 为 用 户 隔离 出 来 的 操作 系统 实例 ， 运 行 在 主 操作 系统 之 上 。 容 
器 提供 了 额外 的 资源 使 用 控制 ， 有 安全 优势 ， 并 且 可 以 快速 搭建 和 销毁 。 

D 日 志 轮 转 ”定期 运行 的 命令 ， 根 据 日 期 重 命名 日 志文 件 ， 可 能 还 会 进行 压缩 以 节省 存储 


空间 。 





















































第 11 章 


口 退出 状态 码 ”程序 结束 时 返回 的 值 。 非 零 值 说 明 有 错误 发 生 。 

口 国际 开放 标准 组 织 (Open Group) 发 布 了 单一 UNIX 规 范 (Single UNIX Specification ) 
的 国际 性 非 营 利 组 织 ， 该 规范 是 一 组 标准 , 用 来 认证 可 以 使 用 UNIX 商标 的 操作 系统 厂商 。 
口 进程 间 通 信 操作 系统 提供 的 程序 间 相 互通 信 的 方法 。 比 如 管道 就 是 用 一 个 程序 的 输出 
作为 另 一 个 程序 的 输入 。 甚 至 连 文件 都 可 以 被 当 作 进程 间 通信 的 一 种 方式 。 

口 参数 ”程序 的 参数 是 在 命令 行 中 提供 的 标志 ， 用 来 指明 启用 或 禁用 某 些 功能 。 

D stderr 用 于 运行 中 程序 输出 错误 信息 的 流 。 

口 stdout 用 于 程序 要 显示 的 信息 的 输出 流 。 

D stdin ”运行 中 程序 的 输入 流 。 

口 重 定向 ”捕获 一 个 程序 的 输出 并 将 其 作为 输入 发 送 给 其 他 程序 或 文件 。 

D shell 能 够 输入 命令 和 查看 结果 的 命令 行 用 户 界面 。 之 所 以 称 为 shell， 是 因为 它 是 包 豆 
在 操作 系统 外 面 的 一 层 。 


第 12 章 

口 Electron 泻 染 进程 ”Chromium Web 视图 。 

口 Electron 主 进程 ”管理 Electron app 并 负责 访问 文件 和 网 络 的 Node 进程 。 
口 原生 ”用 操作 系统 自 带 的 API 写成 的 程序 或 库 。 
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口 JSX React 程 序 使 用 混合 了 JavaScript 的 HTML 片段 。 在 浏览 器 中 运行 前 里 为 纯 
粹 的 JavaScript。 这 种 语言 称 为 JSX。 
口 Chromium ”一 个 开源 的 浏览 器 ，Google Chrome 浏览 器 的 代码 源 自 该 项 目 。 


口 React Facebook 为 搭建 数据 驱动 的 Web 和 移动 端 用 户 界面 提供 的 库 。 


附录 B 


口 网 络 抓 取 将 HTML 转换 成 结构 化 数据 以 便 存储 在 文件 或 数据 库 中 。 

口 微 格式 ”人 类 和 软件 都 能 解读 的 在 HTML 中 包含 结构 化 数据 的 方式 。 因 为 HTML 有 时 不 
能 清晰 地 表示 结构 化 数据 ， 所 以 可 以 在 不 借助 任何 特殊 标签 的 情况 下 用 微 格 式 在 HTML 
中 舰 入 地 址 、 地 理 信息 位 置 、 日 历 条 目 等 数据 。 

口 DOM (文档 对 象 模型 ) 这 个 标准 为 JavaScript 处 理 HTML 定义 了 API。DOM 是 与 语言 

无 关 的 HTML 处 理 接口 。 

口 构造 器 ”创建 并 初始 化 JavaScript 对 象 的 函数 。 

口 XPath 用 来 从 XML 文档 中 选取 节点 的 查询 语句 。 

口 CSV 〈 喜 号 分 隔 的 值 ) 表格 化 数据 的 文本 格式 ， 一 般 用 于 数据 库 或 电子 表格 程序 。 其 中 

的 值 会 用 逗号 分 隔 成 列 ， 用 换行 分 行 。 

口 正则 表达 式 ” 匹配 字符 串 中 的 模式 的 表达 式 。 

口 垂直 搜索 引擎 ” 专注 于 特定 范围 的 搜索 引擎 。 

D robots.txt 网 站 用 来 告诉 网 络 怜 虫 和 抓 取 顺 什 么 内 容 可 以 扫描 或 什么 内 容 不 能 抓 取 的 

标准 。 

































































可 复 “Web 开 发 ”查看 相关 书 单 
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作为 JavaScript 服 务 器 ，Node 支 持 可 伸 
缩 的 高 性 能 Web 应 用 ， 极 大 简化 了 聊天 、 游 戏 
和 实时 数据 分 析 这 样 的 事件 驱动 实时 应 用 程序 
的 开发 ， 其 生态 系统 也 生机 勃 堵 ， 模 块 、 工 
具 、 库 ， 应 有 尽 有 。 

本 书 是 在 《Node.js 实 战 》 基 础 上 打造 的 全 
新 著作 ， 由 多 位 Node 核 心 框架 构建 者 和 经 验 丰 
语 的 Web 开 发 人 员 执 笔 ， 结 合 大 量 实例 介绍 如 
何 用 JavaScript 和 Node 创 建 高 性 能 的 Web 服 
务 器 ， 涵 盖 异 步 编程 、 状 态 管 理 、 事 件 驱 动 编 
旦 等 关键 设计 理念 ， 旨 在 帮助 读者 成 功 晋 级 全 
栈 开 发 。 

@ 前 端 系统 构建 

@ 服务 器 端 框架 选择 

@ 如 何 用 Express 从 头 开 始 搭建 Web 程 序 

@ 与 数据 库 的 交互 

@ 掌握 非 阻塞 /O 

@ Node 的 事件 轮 询 

@ 测试 与 部 署 

@ Web 程 序 模板 

@ 用 Node 开 发 命令 行 工具 和 桌面 软件 
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“这 本 书 由 众 位 大 神 写 来 ， 驾 轻 就 熟地 
告诉 大 家 Node 应 用 该 如 何 编写 。 从 侧面 也 能 
看 出 Node 是 一 个 多 么 轻 量 级 的 平台 。 期 望 你 
看 完 之 后 也 能 驾轻就熟 地 编写 属于 自己 的 
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如 果 您 对 本 书 内 容 有 疑问 ， 可 发 邮件 至 contact@turingbook.com， 会 有 编辑 或 作 
译 者 协助 答疑 。 也 可 访问 图 灵 社 区 ， 参 与 本 书 讨论 。 
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